Skip to main content

FastAPI Startkit

codecov PyPI version Python versions

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/resolve auto-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 Router wrapper around FastAPI's APIRouter with a resource() 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)

Source distribution for fastapi-startkit 0.76.0
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)

Table of built distributions (wheels) for fastapi-startkit 0.76.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.76.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page