FastAPI CLI
Source Code: https://github.com/fastapi/fastapi-cli
Run and manage FastAPI apps from the command line with FastAPI CLI. 🚀
Description
FastAPI CLI is a command line program fastapi that you can use to serve your FastAPI app, manage your FastAPI project, and more.
When you install FastAPI (e.g. with pip install "fastapi[standard]"), it includes a package called fastapi-cli, this package provides the fastapi command in the terminal.
To run your FastAPI app for development, you can use the fastapi dev command:
$ fastapi dev main.py
FastAPI Starting development server 🚀
Searching for package file structure from directories with __init__.py files
Importing from /home/user/code/awesomeapp
module 🐍 main.py
code Importing the FastAPI app object from the module with the following code:
from main import app
app Using import string: main:app
server Server started at http://127.0.0.1:8000
server Documentation at http://127.0.0.1:8000/docs
tip Running in development mode, for production use: fastapi run
Logs:
INFO Will watch for changes in these directories: ['/home/user/code/awesomeapp']
INFO Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO Started reloader process [4106097] using WatchFiles
INFO Started server process [4106120]
INFO Waiting for application startup.
INFO Application startup complete.
That command line program called fastapi is FastAPI CLI.
FastAPI CLI takes the path to your Python program and automatically detects the variable with the FastAPI (commonly named app) and how to import it, and then serves it.
For production you would use fastapi run instead. 🚀
Internally, FastAPI CLI uses Uvicorn, a high-performance, production-ready, ASGI server. 😎
fastapi dev
When you run fastapi dev, it will run on development mode.
By default, it will have auto-reload enabled, so it will automatically reload the server when you make changes to your code. This is resource intensive and could be less stable than without it, you should only use it for development.
By default it will listen on the IP address 127.0.0.1, which is the IP for your machine to communicate with itself alone (localhost).
Before importing your app, fastapi dev sets the FASTAPI_ENV environment variable to development. If FASTAPI_ENV is already set, its existing value is preserved. This lets app startup code choose development-friendly behavior while allowing you to provide an app-specific environment such as staging.
The conventional FASTAPI_ENV values are development and production. fastapi run currently leaves FASTAPI_ENV unchanged, so set it explicitly if your app needs to detect production mode.
fastapi run
When you run fastapi run, it will run on production mode by default.
It will have auto-reload disabled by default.
It will listen on the IP address 0.0.0.0, which means all the available IP addresses, this way it will be publicly accessible to anyone that can communicate with the machine. This is how you would normally run it in production, for example, in a container.
In most cases you would (and should) have a "termination proxy" handling HTTPS for you on top, this will depend on how you deploy your application, your provider might do this for you, or you might need to set it up yourself. You can learn more about it in the FastAPI Deployment documentation.
License
This project is licensed under the terms of the MIT license.
1 maintainer
Release files for fastapi-cli 0.0.32
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fastapi_cli-0.0.32.tar.gz | 26.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fastapi_cli-0.0.32-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 41.3 kB
Release files / fastapi_cli-0.0.32.tar.gz
| Download URL | fastapi_cli-0.0.32.tar.gz |
|---|---|
| Size | 26.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
38024d2345275e1b37ce8848727a580d84901b570e96b3256d9d36a9a5039424
|
|
BLAKE2b-256 checksum How to use checksums |
33eb3b534c6f8e157f9ddbf2a153512307c886cad0b258739c200dd8ff8c4452
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.4 {"installer":{"name":"uv","version":"0.11.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / fastapi_cli-0.0.32-py3-none-any.whl
| Download URL | fastapi_cli-0.0.32-py3-none-any.whl |
|---|---|
| Size | 14.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8dcc286fa32f01bbd3f65dd09cfd5a2540ed5f2230b77db7fd30978d6165f3c4
|
|
BLAKE2b-256 checksum How to use checksums |
d55356ae5ae17bb0a5d89d1d31e5320eb1865553ebbfbde91cdc4c221245f2a8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.4 {"installer":{"name":"uv","version":"0.11.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
