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.77.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.77.0
File Size Uploaded Provenance Actions
fastapi_startkit-0.77.0.tar.gz 305.8 kB Without provenance Details for fastapi_startkit-0.77.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for fastapi-startkit 0.77.0
File Interpreter ABI Platform Actions
fastapi_startkit-0.77.0-py3-none-any.whl Python 3 none any Details for fastapi_startkit-0.77.0-py3-none-any.whl

Total release size: 801.5 kB

Release files / fastapi_startkit-0.77.0.tar.gz

Download URL fastapi_startkit-0.77.0.tar.gz
Size 305.8 kB
Tags Source
SHA-256 checksum
How to use checksums
6528258552b21412fccd6ec6769e0318c519d5dd182c6c46244e3fbecd161c7c
BLAKE2b-256 checksum
How to use checksums
e8f87c62c254d2822c0e844da796c4b8bc85ff46eb7977d2cc064d6a93b752ef
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.77.0-py3-none-any.whl

Download URL fastapi_startkit-0.77.0-py3-none-any.whl
Size 495.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6fd4f074d54d381484b4c1247a52623ed5ba6f1cb51b7856989ba196b07d0fb0
BLAKE2b-256 checksum
How to use checksums
a86c196e37d0f2494105a6ad40ee1c845eec9bd28342ba97ba82e1fb77114d44
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.77.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.77.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