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.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.75.0
File Size Uploaded Provenance Actions
fastapi_startkit-0.75.0.tar.gz 295.3 kB Without provenance Details for fastapi_startkit-0.75.0.tar.gz

Built distribution (wheel)

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

Total release size: 772.9 kB

Release files / fastapi_startkit-0.75.0.tar.gz

Download URL fastapi_startkit-0.75.0.tar.gz
Size 295.3 kB
Tags Source
SHA-256 checksum
How to use checksums
d03ccb0f17ee6a8f52e5021e4a38629cfe583b5ef1515c6d2a650159178ed20c
BLAKE2b-256 checksum
How to use checksums
2cd8a3c6677c852e966eac913db172ac80b2cd27557a419c83ddb2171d649f86
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.0-py3-none-any.whl

Download URL fastapi_startkit-0.75.0-py3-none-any.whl
Size 477.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f0010791b1fd421190e1269aa71f33b609e49f9a82d01fbd4a1c74e918ddb1ca
BLAKE2b-256 checksum
How to use checksums
f0c8947f27777e51cb6dccc326034c1bfbd4f381b5cbe91153a1f958a7a70a33
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.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.75.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