Install & Compatibility
Where this runs
tested against v0.23.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 82.6MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 8.3s · import 0.000s · 85MB
86MB installed
● package 86MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
fastapi cloud
✓ This is primarily a CLI tool and not typically imported directly into Python code. Usage is via the `fastapi` command on the command line.
The `fastapi` command provides subcommands like `fastapi cloud deploy`, `fastapi cloud login`, etc.
This quickstart demonstrates how to initialize a FastAPI project, create a simple FastAPI application, log in to FastAPI Cloud, and deploy the application using the `fastapi` CLI. The `fastapi[standard]` installation includes `fastapi-cloud-cli`.
# 1. Create a new FastAPI project (requires uv or pip)
# Using uv (recommended):
# uv init myapp
# cd myapp
# uv add "fastapi[standard]"
# Using pip:
mkdir myapp
cd myapp
pip install "fastapi[standard]"
# 2. Create a basic FastAPI application (main.py)
# (Content of main.py)
# from fastapi import FastAPI
# app = FastAPI()
# @app.get("/")
# def read_root():
# return {"message": "Hello, FastAPI Cloud!"}
# 3. Log in to FastAPI Cloud (if not already logged in)
# This will open a browser for authentication.
# fastapi login
# 4. Deploy your application
# The CLI will detect your app, and for the first deployment,
# it will prompt to select/create a team and app.
# Ensure FASTAPI_CLOUD_TOKEN is set for CI/CD or non-interactive use.
# For example: export FASTAPI_CLOUD_TOKEN=os.environ.get('FASTAPI_CLOUD_TOKEN', '')
fastapi deploy
fastapi-cloud --version
Debug
Known issues
breakingVersion 0.13.0 dropped official support for Python 3.9. Users on Python 3.9 must upgrade their Python version to 3.10 or newer.fixUpgrade Python environment to 3.10 or higher.
affects: 0.13.0 and later
gotchaWhen `fastapi-cloud-cli` is installed as part of `fastapi[standard]`, it may attempt to create configuration files in privileged root paths (e.g., `/.config`). This can cause deployment failures in restricted environments like some Kubernetes setups.fixIf FastAPI Cloud deployment features are not explicitly needed, install FastAPI using `pip install "fastapi[standard-no-fastapi-cloud-cli]"` to avoid including `fastapi-cloud-cli`.
affects: All versions bundled with `fastapi[standard]`
gotchaDeployment might fail with 'Build Failed When Installing Dependencies' if required packages do not have pre-built wheels for your specific Python version. This is common when using a very new or less common Python version.fixPin your Python version to one known to have pre-built wheels available for all your project's dependencies. Consult your dependency documentation for compatible Python versions.
affects: All versions
gotchaOn Windows, the `fastapi` command might not be found in the PATH after installation, leading to 'command not found' errors.fixEnsure that the directory where `pip` installs executables (often in a virtual environment's `Scripts` directory) is added to your system's PATH environment variable. Alternatively, invoke it using `python -m fastapi_cloud_cli` if direct `fastapi` alias isn't resolving.
affects: All versions on Windows
Upgrade
Version history
0.23.0latest on PyPI · released Jul 28, 2026
Audit
Dependencies
pythonrequiredRequires Python 3.10 or higher.
fastapioptionalOften installed as a dependency of fastapi[standard], providing direct integration for FastAPI Cloud deployments.