FastAPI Cloud CLI

FastAPI Cloud CLI is the official command-line tool for deploying and managing FastAPI applications on FastAPI Cloud, from the team behind FastAPI. It handles the full lifecycle from the terminal — authenticating, linking a local project to a cloud app, deploying, and inspecting running deployments.

Built on Typer, it groups commands for apps, teams, tokens, environment variables, deployments, and logs, so you can create an app, push a deploy, set env vars, and tail logs without leaving the shell. It is distributed as part of the FastAPI CLI experience and packages up your project, uploads it, and manages the cloud resources behind a FastAPI service.

What You Get

• login/logout/whoami commands for authenticating with FastAPI Cloud
• A deploy command that packages the local project and ships it to the cloud
• App management commands to create, link, list, update, and unlink apps
• Environment-variable, teams, tokens, deployments, and logs subcommands
• A Typer-powered CLI with rich terminal output and CI-friendly modes

Common Use Cases

• Deploying a FastAPI application to FastAPI Cloud from a developer machine
• Managing environment variables and secrets for a cloud app
• Linking a local repository to a FastAPI Cloud app and pushing updates
• Running deploys from CI pipelines with token-based authentication

Under The Hood

Architecture - The package lives under src/fastapi_cloud_cli. cli.py is the Typer entrypoint that mounts a commands/ tree, where each concern is its own module or subpackage: deploy/, apps/ (create, get, link, list, unlink, update), auth/, login.py/logout.py, env/, teams/, tokens/, deployments.py, and logs.py. An _flow.py drives interactive prompts, config.py persists project/app linkage, and utils/ wraps the HTTP API client that talks to FastAPI Cloud.

Tech Stack - Python 3.10+ built on Typer for the CLI, rich-toolkit for terminal UX, httpx for API calls, Pydantic (with email extras) for models, uvicorn for local serving, rignore for respecting ignore files when packaging, fastar for archiving the project, and sentry-sdk for error reporting.

Code Quality - The repository is well-engineered: a broad tests/ suite covers auth, deploy, env, CLI CI flows, and the API client; it ships py.typed, tracks coverage with a badge, and shows very active, consistent maintenance. Dependencies are carefully version-pinned across Python releases.

API Design - As a CLI, its surface is the command tree, which mirrors the mental model of the platform (apps, deployments, env, teams) and reads naturally. Rich output and interactive flows lower the learning curve, and CI token support keeps it scriptable, though the tool is inherently coupled to the FastAPI Cloud service.