fastapi-cloud-cli
Deploy and manage FastAPI Cloud apps from the command line đ
Description
# FastAPI Cloud CLI <a href="https://github.com/fastapilabs/fastapi-cloud-cli/actions/workflows/test.yml" target="_blank"> <img src="https://github.com/fastapilabs/fastapi-cloud-cli/actions/workflows/test.yml/badge.svg" alt="Test"> </a> <a href="https://github.com/fastapilabs/fastapi-cloud-cli/actions/workflows/publish.yml" target="_blank"> <img src="https://github.com/fastapilabs/fastapi-cloud-cli/actions/workflows/publish.yml/badge.svg" alt="Publish"> </a> <a href="https://coverage-badge.samuelcolvin.workers.dev/redirect/fastapilabs/fastapi-cloud-cli" target="_blank"> <img src="https://coverage-badge.samuelcolvin.workers.dev/fastapilabs/fastapi-cloud-cli.svg" alt="Coverage"> <a href="https://pypi.org/project/fastapi-cloud-cli" target="_blank"> <img src="https://img.shields.io/pypi/v/fastapi-cloud-cli?color=%2334D058&label=pypi%20package" alt="Package version"> </a> --- **Source Code**: <a href="https://github.com/fastapilabs/fastapi-cloud-cli" target="_blank">https://github.com/fastapilabs/fastapi-cloud-cli</a> --- ## License This project is licensed under the terms of the MIT license.
Release History
| Version | Changes | Urgency | Date |
|---|---|---|---|
| 0.19.0 | ### Features * ⨠Improve `env list` output. PR [#203](https://github.com/fastapilabs/fastapi-cloud-cli/pull/203) by [@patrick91](https://github.com/patrick91). * đ Add debug logging in `fastapi login` command. PR [#207](https://github.com/fastapilabs/fastapi-cloud-cli/pull/207) by [@YuriiMotov](https://github.com/YuriiMotov). ### Refactors * âģī¸ Do not suggest `src` as a directory that could contain a `pyproject.toml`. PR [#211](https://github.com/fastapilabs/fastapi-cloud-cli/pull/211 | High | 6/1/2026 |
| 0.18.0 | ### Features * đ¸ Show Top-3 files larger than threshold on `deploy` command. PR [#190](https://github.com/fastapilabs/fastapi-cloud-cli/pull/190) by [@YuriiMotov](https://github.com/YuriiMotov). * ⨠Show if there's a new fastapi-cloud-cli version available. PR [#201](https://github.com/fastapilabs/fastapi-cloud-cli/pull/201) by [@patrick91](https://github.com/patrick91). ### Refactors * âģī¸ Rename `app_slug` parameter of `_get_app` to `app_id`. PR [#192](https://github.com/fastapilabs/ | High | 5/22/2026 |
| 0.17.1 | ### Fixes * đ Improve error message when receiving a 403. PR [#189](https://github.com/fastapilabs/fastapi-cloud-cli/pull/189) by [@patrick91](https://github.com/patrick91). ### Internal * âŦ Bump astral-sh/setup-uv from 7.6.0 to 8.1.0. PR [#182](https://github.com/fastapilabs/fastapi-cloud-cli/pull/182) by [@dependabot[bot]](https://github.com/apps/dependabot). | High | 4/27/2026 |
| 0.17.0 | Imported from PyPI (0.17.0) | Low | 4/21/2026 |
| 0.16.1 | ### Fixes * đ Fix archive creation of Windows files inside WSL. PR [#178](https://github.com/fastapilabs/fastapi-cloud-cli/pull/178) by [@DoctorJohn](https://github.com/DoctorJohn). | Medium | 4/8/2026 |
| 0.16.0 | ### Features * ⨠Update deployment statuses. PR [#176](https://github.com/fastapilabs/fastapi-cloud-cli/pull/176) by [@DoctorJohn](https://github.com/DoctorJohn). * đ Show deployment upload progress. PR [#171](https://github.com/fastapilabs/fastapi-cloud-cli/pull/171) by [@YuriiMotov](https://github.com/YuriiMotov). ### Internal * đ Pin GitHub actions by commit SHA. PR [#172](https://github.com/fastapilabs/fastapi-cloud-cli/pull/172) by [@YuriiMotov](https://github.com/YuriiMotov). | Medium | 4/7/2026 |
| 0.15.1 | ### Features * đ Allow filtering for teams and apps. PR [#169](https://github.com/fastapilabs/fastapi-cloud-cli/pull/169) by [@YuriiMotov](https://github.com/YuriiMotov). ### Internal * đĨ Remove unused `tests/assets`. PR [#170](https://github.com/fastapilabs/fastapi-cloud-cli/pull/170) by [@YuriiMotov](https://github.com/YuriiMotov). | Medium | 3/26/2026 |
| 0.15.0 | ### Features * ⨠Add `fastapi cloud setup-ci`. PR [#157](https://github.com/fastapilabs/fastapi-cloud-cli/pull/157) by [@savannahostrowski](https://github.com/savannahostrowski). ### Internal * đˇ Add `ty` to precommit. PR [#167](https://github.com/fastapilabs/fastapi-cloud-cli/pull/167) by [@svlandeg](https://github.com/svlandeg). | Low | 3/11/2026 |
| 0.14.1 | ### Fixes * đ Fix nested progress in deploy causing weird output. PR [#166](https://github.com/fastapilabs/fastapi-cloud-cli/pull/166) by [@patrick91](https://github.com/patrick91). ### Docs * đ Add dates to release notes. PR [#161](https://github.com/fastapilabs/fastapi-cloud-cli/pull/161) by [@YuriiMotov](https://github.com/YuriiMotov). ### Internal * âŦ Bump tiangolo/latest-changes from 0.4.0 to 0.4.1. PR [#162](https://github.com/fastapilabs/fastapi-cloud-cli/pull/162) by [@d | Low | 3/8/2026 |
| 0.14.0 | ### Features * ⨠Wait for verification after building. PR [#160](https://github.com/fastapilabs/fastapi-cloud-cli/pull/160) by [@patrick91](https://github.com/patrick91). ### Refactors * đ Update how we show messages. PR [#159](https://github.com/fastapilabs/fastapi-cloud-cli/pull/159) by [@patrick91](https://github.com/patrick91). ### Internal * đˇ Add `windows-latest` to test matrix. PR [#158](https://github.com/fastapilabs/fastapi-cloud-cli/pull/158) by [@YuriiMotov](https:/ | Low | 2/25/2026 |
| 0.13.0 | ### Breaking Changes * â Drop support for Python 3.9. PR [#156](https://github.com/fastapilabs/fastapi-cloud-cli/pull/156) by [@tiangolo](https://github.com/tiangolo). | Low | 2/17/2026 |
| 0.12.0 | ### Features * ⨠Allow to specify application directory. PR [#155](https://github.com/fastapilabs/fastapi-cloud-cli/pull/155) by [@patrick91](https://github.com/patrick91). ### Refactors * âģī¸ Improve how we handle invalid tokens. PR [#153](https://github.com/fastapilabs/fastapi-cloud-cli/pull/153) by [@patrick91](https://github.com/patrick91). * â Isolate tests from config. PR [#152](https://github.com/fastapilabs/fastapi-cloud-cli/pull/152) by [@patrick91](https://github.com/patrick91 | Low | 2/13/2026 |
| 0.11.0 | ### Features * ⨠Add link command. PR [#148](https://github.com/fastapilabs/fastapi-cloud-cli/pull/148) by [@patrick91](https://github.com/patrick91). ### Fixes * đ Exclude .env files from deployment uploads. PR [#150](https://github.com/fastapilabs/fastapi-cloud-cli/pull/150) by [@patrick91](https://github.com/patrick91). | Low | 1/15/2026 |
| 0.10.1 | ### Fixes * đ Fix `env list` for secret environment variables. PR [#147](https://github.com/fastapilabs/fastapi-cloud-cli/pull/147) by [@patrick91](https://github.com/patrick91). | Low | 1/13/2026 |
| 0.10.0 | ### Features * `fastapi cloud logs`. PR [#132](https://github.com/fastapilabs/fastapi-cloud-cli/pull/132) by [@savannahostrowski](https://github.com/savannahostrowski). * ⨠Add support for creating secrets. PR [#146](https://github.com/fastapilabs/fastapi-cloud-cli/pull/146) by [@patrick91](https://github.com/patrick91). | Low | 1/13/2026 |
| 0.9.0 | ### Features * ⨠Add support for app ID in `fastapi deploy`. PR [#144](https://github.com/fastapilabs/fastapi-cloud-cli/pull/144) by [@buurro](https://github.com/buurro). * ⨠Add support for FASTAPI_CLOUD_TOKEN environment variable auth. PR [#142](https://github.com/fastapilabs/fastapi-cloud-cli/pull/142) by [@patrick91](https://github.com/patrick91). * ⨠Add a confirmation step to the first CLI deployment . PR [#140](https://github.com/fastapilabs/fastapi-cloud-cli/pull/140) by [@alejsdev] | Low | 1/9/2026 |
| 0.8.0 | ### Fixes * đ Fix CI ran all tests on oldest supported Python. PR [#136](https://github.com/fastapilabs/fastapi-cloud-cli/pull/136) by [@DoctorJohn](https://github.com/DoctorJohn). ### Refactors * âģī¸ Reorder log messages for deployment readiness. PR [#137](https://github.com/fastapilabs/fastapi-cloud-cli/pull/137) by [@alejsdev](https://github.com/alejsdev). ### Upgrades * â Drop support for Pydantic v1. PR [#139](https://github.com/fastapilabs/fastapi-cloud-cli/pull/139) by [@ | Low | 12/23/2025 |
| 0.7.0 | ### Features * ⨠Add upload cancellation notification on keyboard interrupt. PR [#129](https://github.com/fastapilabs/fastapi-cloud-cli/pull/129) by [@patrick91](https://github.com/patrick91). ### Fixes * đ Handle TimeoutError when waiting for deployment. PR [#131](https://github.com/fastapilabs/fastapi-cloud-cli/pull/131) by [@buurro](https://github.com/buurro). ### Internal * â Fix test coverage. PR [#130](https://github.com/fastapilabs/fastapi-cloud-cli/pull/130) by [@patrick9 | Low | 12/16/2025 |
| 0.6.0 | ### Features * âĄī¸ Compress code archives to speed up uploads. PR [#125](https://github.com/fastapilabs/fastapi-cloud-cli/pull/125) by [@DoctorJohn](https://github.com/DoctorJohn). ### Refactors * âŦī¸ Migrate to uv. PR [#127](https://github.com/fastapilabs/fastapi-cloud-cli/pull/127) by [@DoctorJohn](https://github.com/DoctorJohn). * đĨ Remove path confirmation on first deployment. PR [#123](https://github.com/fastapilabs/fastapi-cloud-cli/pull/123) by [@buurro](https://github.com/buurro | Low | 12/4/2025 |
| 0.5.2 | ### Fixes * đ Fix archive file was not closed after upload. PR [#122](https://github.com/fastapilabs/fastapi-cloud-cli/pull/122) by [@DoctorJohn](https://github.com/DoctorJohn). | Low | 11/25/2025 |
| 0.5.1 | ### Fixes * âī¸ Fix logout suggestion message. PR [#118](https://github.com/fastapilabs/fastapi-cloud-cli/pull/118) by [@buurro](https://github.com/buurro). ### Refactors * âģī¸ Improve waitlist success command. PR [#117](https://github.com/fastapilabs/fastapi-cloud-cli/pull/117) by [@patrick91](https://github.com/patrick91). | Low | 11/20/2025 |
| 0.5.0 | ### Features * ⨠Resume build log stream if interrupted. PR [#109](https://github.com/fastapilabs/fastapi-cloud-cli/pull/109) by [@buurro](https://github.com/buurro). ### Internal * đˇ Add support for Pydantic v1. PR [#116](https://github.com/fastapilabs/fastapi-cloud-cli/pull/116) by [@patrick91](https://github.com/patrick91). * đ§ Add labels to Dependabot updates. PR [#113](https://github.com/fastapilabs/fastapi-cloud-cli/pull/113) by [@alejsdev](https://github.com/alejsdev). | Low | 11/20/2025 |
| 0.4.0 | ### Features * ⨠Add fastapi cloud sub-command. PR [#104](https://github.com/fastapilabs/fastapi-cloud-cli/pull/104) by [@buurro](https://github.com/buurro). * ⨠Check if token is expired when checking if user is logged in. PR [#105](https://github.com/fastapilabs/fastapi-cloud-cli/pull/105) by [@patrick91](https://github.com/patrick91). * ⨠Support the verification skipped status. PR [#99](https://github.com/fastapilabs/fastapi-cloud-cli/pull/99) by [@DoctorJohn](https://github.com/DoctorJ | Low | 11/19/2025 |
| 0.3.1 | ### Fixes * đ Fix login url not linked correctly. PR [#89](https://github.com/fastapilabs/fastapi-cloud-cli/pull/89) by [@patrick91](https://github.com/patrick91). ### Refactors * âģī¸ Refactor env vars creation . PR [#92](https://github.com/fastapilabs/fastapi-cloud-cli/pull/92) by [@alejsdev](https://github.com/alejsdev). * đĨ Remove env vars from deploy workflow. PR [#93](https://github.com/fastapilabs/fastapi-cloud-cli/pull/93) by [@alejsdev](https://github.com/alejsdev). ### Int | Low | 10/9/2025 |
| 0.3.0 | ### Features * ⨠Add support for `.fastapicloudignore` file. PR [#83](https://github.com/fastapilabs/fastapi-cloud-cli/pull/83) by [@patrick91](https://github.com/patrick91). ### Internal * âŦ Bump actions/download-artifact from 4 to 5. PR [#69](https://github.com/fastapilabs/fastapi-cloud-cli/pull/69) by [@dependabot[bot]](https://github.com/apps/dependabot). * âŦ Update pre-commit requirement from <4.0.0,>=2.17.0 to >=2.17.0,<5.0.0. PR [#28](https://github.com/fastapilabs/fastapi-cloud | Low | 10/2/2025 |
| 0.2.1 | ### Features * ⨠Add support for verification statuses. PR [#82](https://github.com/fastapilabs/fastapi-cloud-cli/pull/82) by [@DoctorJohn](https://github.com/DoctorJohn). | Low | 9/25/2025 |
| 0.2.0 | ### Features * ⨠Add unlink command to delete local FastAPI Cloud configuration. PR [#80](https://github.com/fastapilabs/fastapi-cloud-cli/pull/80) by [@alejsdev](https://github.com/alejsdev). * ⨠Add support for granular failure statuses. PR [#75](https://github.com/fastapilabs/fastapi-cloud-cli/pull/75) by [@DoctorJohn](https://github.com/DoctorJohn). | Low | 9/18/2025 |
| 0.1.5 | ### Features * đ§âđģ Handle HTTP errors when streaming build logs. PR [#65](https://github.com/fastapilabs/fastapi-cloud-cli/pull/65) by [@patrick91](https://github.com/patrick91). | Low | 7/28/2025 |
| 0.1.4 | ### Fixes * đ Always load settings lazily. PR [#64](https://github.com/fastapilabs/fastapi-cloud-cli/pull/64) by [@patrick91](https://github.com/patrick91). | Low | 7/11/2025 |
| 0.1.3 | ### Fixes * đ Remove redundant thank you message. PR [#63](https://github.com/fastapilabs/fastapi-cloud-cli/pull/63) by [@patrick91](https://github.com/patrick91). | Low | 7/10/2025 |
| 0.1.2 | ## What's Changed * â Refactor tests by @patrick91 in https://github.com/fastapilabs/fastapi-cloud-cli/pull/62 * âŦī¸ Relax httpx dependency by @patrick91 in https://github.com/fastapilabs/fastapi-cloud-cli/pull/61 **Full Changelog**: https://github.com/fastapilabs/fastapi-cloud-cli/compare/0.1.1...0.1.2 | Low | 7/8/2025 |
| 0.1.1 | Initial public release đ Register to the waiting list here: https://fastapicloud.com/ đ | Low | 7/7/2025 |
