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.75.2

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.75.2
File Size Uploaded Provenance Actions
fastapi_startkit-0.75.2.tar.gz 296.5 kB Without provenance Details for fastapi_startkit-0.75.2.tar.gz

Built distribution (wheel)

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

Total release size: 775.8 kB

Release files / fastapi_startkit-0.75.2.tar.gz

Download URL fastapi_startkit-0.75.2.tar.gz
Size 296.5 kB
Tags Source
SHA-256 checksum
How to use checksums
68db3d96d237456067188400f1a9f2f35720a7979da177e9d2d9607b5eb00b8d
BLAKE2b-256 checksum
How to use checksums
8264568547fe3ed9caa69a9a3e4a2e9fd9038f585428f7232a35a5d633a920c8
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.75.2-py3-none-any.whl

Download URL fastapi_startkit-0.75.2-py3-none-any.whl
Size 479.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7280f0277c8d28cdae411b0a94f8f48d98909e42800d03cf8ed5e8d97f1ab41a
BLAKE2b-256 checksum
How to use checksums
4d13d6951525784343bdef58679f6b79d896803825c2809f7739d8a3f5459f6d
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.75.2

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.75.2 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