{"id":981,"library":"fastapi-cloud-cli","title":"FastAPI Cloud CLI","description":"fastapi-cloud-cli is a command-line interface tool for deploying and managing FastAPI applications on FastAPI Cloud. It provides commands for logging in, deploying, managing environment variables, and streaming logs. The library is actively maintained, with frequent releases, and is currently at version 0.15.1.","status":"active","version":"0.15.1","language":"python","source_language":"en","source_url":"https://github.com/fastapilabs/fastapi-cloud-cli","tags":["cli","deployment","fastapi","cloud"],"install":[{"cmd":"pip install fastapi-cloud-cli","lang":"bash","label":"Direct installation"},{"cmd":"pip install \"fastapi[standard]\"","lang":"bash","label":"As part of FastAPI's standard dependencies"}],"dependencies":[{"reason":"Requires Python 3.10 or higher.","package":"python","optional":false},{"reason":"Often installed as a dependency of fastapi[standard], providing direct integration for FastAPI Cloud deployments.","package":"fastapi","optional":true}],"imports":[{"note":"The `fastapi` command provides subcommands like `fastapi cloud deploy`, `fastapi cloud login`, etc.","symbol":"fastapi cloud","correct":"This is primarily a CLI tool and not typically imported directly into Python code. Usage is via the `fastapi` command on the command line."}],"quickstart":{"code":"# 1. Create a new FastAPI project (requires uv or pip)\n# Using uv (recommended):\n# uv init myapp\n# cd myapp\n# uv add \"fastapi[standard]\"\n\n# Using pip:\nmkdir myapp\ncd myapp\npip install \"fastapi[standard]\"\n\n# 2. Create a basic FastAPI application (main.py)\n# (Content of main.py)\n# from fastapi import FastAPI\n# app = FastAPI()\n# @app.get(\"/\")\n# def read_root():\n#     return {\"message\": \"Hello, FastAPI Cloud!\"}\n\n# 3. Log in to FastAPI Cloud (if not already logged in)\n# This will open a browser for authentication.\n# fastapi login\n\n# 4. Deploy your application\n# The CLI will detect your app, and for the first deployment,\n# it will prompt to select/create a team and app.\n# Ensure FASTAPI_CLOUD_TOKEN is set for CI/CD or non-interactive use.\n# For example: export FASTAPI_CLOUD_TOKEN=os.environ.get('FASTAPI_CLOUD_TOKEN', '')\nfastapi deploy","lang":"bash","description":"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`."},"warnings":[{"fix":"Upgrade Python environment to 3.10 or higher.","message":"Version 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.","severity":"breaking","affected_versions":"0.13.0 and later"},{"fix":"If 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`.","message":"When `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.","severity":"gotcha","affected_versions":"All versions bundled with `fastapi[standard]`"},{"fix":"Pin 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.","message":"Deployment 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.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Ensure 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.","message":"On Windows, the `fastapi` command might not be found in the PATH after installation, leading to 'command not found' errors.","severity":"gotcha","affected_versions":"All versions on Windows"}],"env_vars":null,"search_vec":"'0.15.1':50 'activ':40 'applic':20 'cli':3,7,51 'cloud':2,6,23,54 'command':11,26 'command-lin':10 'current':47 'deploy':16,30,52 'environ':32 'fastapi':1,5,19,22,53 'fastapi-cloud-c':4 'frequent':43 'interfac':13 'librari':38 'line':12 'log':28,36 'maintain':41 'manag':18,31 'provid':25 'releas':44 'stream':35 'tool':14 'variabl':33 'version':49","created_at":"2026-03-29T08:37:24.709006+00:00","updated_at":"2026-04-16T14:56:28.478538+00:00","problems":{"verify_error":"no import statement found"},"ecosystem":"pypi","meta_description":null,"install_score":0,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.23.0","cli_name":"fastapi-cloud","cli_version":"sh: 1: fastapi-cloud: not found","type":"library","homepage":"https://fastapi.cloud","github":"https://github.com/fastapilabs/fastapi-cloud-cli","docs":"https://fastapi.tiangolo.com/fastapi-cloud-cli/","changelog":"https://github.com/fastapilabs/fastapi-cloud-cli/blob/main/release-notes.md","pypi":"https://pypi.org/project/fastapi-cloud-cli/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["aws","devops","web-framework"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-28","last_verified":"2026-08-27","next_check":"2026-07-05","install_tag":"stale"}}