FastAPI Startkit
A modular, provider-driven framework for building Python applications with FastAPI. It bundles a service container, configuration system, facades, and a Cleo-powered console into a single cohesive foundation.
Installation
Create a new application with the installer. It requires uv:
uvx fastapi-startkit init my-app
The installer asks which services, database, and frontend to set up, generates the project, and runs
uv sync. Then start the server:
cd my-app
uv run python artisan serve
Pass . to create the application in the current empty directory, or skip the prompts with options:
uvx fastapi-startkit init . --no-interaction
uvx fastapi-startkit init my-app --app=web --frontend=react
| Option | Values |
|---|---|
--app |
web (default), worker, or both |
--database |
none, sqlite (default), postgres, or mysql |
--frontend |
none (default), react, or vue |
--dry-run |
Show the plan without creating files |
--no-deps |
Generate files without installing Python dependencies |
-n, --no-interaction |
Use the defaults and option values without prompting |
Run uvx fastapi-startkit init --help for the full reference.
Adding to an existing project
uv add fastapi-startkit
Optional extras enable additional capabilities:
fastapi-startkit[fastapi] # FastAPI + Starlette
fastapi-startkit[vite] # Jinja2 for Vite integration
fastapi-startkit[ai] # LangChain agents
Python versions
Python 3.12, 3.13, 3.14 and 3.15 are supported.
Features
- Service container — IoC container with
bind/make/resolveauto-wiring and lifecycle hooks. - Configuration — dataclass-based config sourced from the environment with dotted-key access.
- Providers — two-phase (
register/boot) service registration. - Routing — a
Routerwrapper around FastAPI'sAPIRouterwith aresource()CRUD shortcut. - Facades — static-like access to container-resolved services (
Config,Auth, ...). - Console — Cleo-based CLI (
artisan) for serving the application and code generation.
Documentation
Full documentation is available at fastapi-startkit.github.io.
Development
# Install dependencies
uv sync --group dev --extra database --extra sqlite --extra fastapi --extra vite --extra postgres
# Run the test suite
uv run pytest tests/ -v
# Run tests with coverage
uv run pytest --cov --cov-report=term-missing
Coverage is collected in CI and reported to Codecov.
License
Released under the MIT License.
Metadata
Release files for fastapi-startkit 0.76.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| fastapi_startkit-0.76.0.tar.gz | 296.5 kB | Without provenance | Details for fastapi_startkit-0.76.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| fastapi_startkit-0.76.0-py3-none-any.whl | Python 3 | none | any | Details for fastapi_startkit-0.76.0-py3-none-any.whl |
Total release size: 775.7 kB
Release files / fastapi_startkit-0.76.0.tar.gz
| Download URL | fastapi_startkit-0.76.0.tar.gz |
|---|---|
| Size | 296.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c410e4875b19899677e5edd7d85a8a5ff113a69ce52d00d01e6a8a913a768f06
|
|
BLAKE2b-256 checksum How to use checksums |
1683c9f23422ca49e8e0d1c16c4216366693bc2a7f2963fc5a074f89401aad63
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.15.0
|
Release files / fastapi_startkit-0.76.0-py3-none-any.whl
| Download URL | fastapi_startkit-0.76.0-py3-none-any.whl |
|---|---|
| Size | 479.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3ee84dcd0c007861e75951a9e6f7aa2b0641369c586abbfdc51d0a2e2c706d98
|
|
BLAKE2b-256 checksum How to use checksums |
9f637c7dbaa8179a7180cbbb361a28934d8036353922e8b16b995b112471fb3b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.15.0
|
Security for fastapi-startkit 0.76.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.