fastapi-clean-example

Practical Clean Architecture backend example built with FastAPI. No stateful globals (DI), low coupling (DIP), tactical DDD, CQRS, proper UoW usage. REST API, per-route error handling, session-based auth, contextual RBAC. Bundled with extensive docs and modern tooling

#alembic#api#architecture#clean-architecture#cqrs#crud

View Repository on GitHub ↗

REPOSITORY OVERVIEW

Live repository statistics

★ 572Stars

⑂ 78Forks

◯ 0Open issues

◉ 572Watchers

86/100

OPENREPOHUB HEALTH SIGNAL

Strong signals

A transparent discovery signal based on current public GitHub metadata.

Recent activity35% weight

100

Community adoption25% weight

Maintenance state20% weight

100

License clarity10% weight

100

Project information10% weight

This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.

README preview

Stay tuned. Refactor in progress, see legacy-2025 branch for architecture docs

TODO:

Write tests
Explain code and patterns in new README
Make template project

Prerequisites

uv sync
source .venv/bin/activate
pre-commit install --hook-type pre-commit --hook-type pre-push

Start in Docker

make upd

Start locally

make upd-local
alembic upgrade head
uvicorn app.main.run:make_app --host 0.0.0.0 --port 8000 --reload
# or `src/app/main/run.py` in IDE

Full API access:

create user via sign up
set its role to super_admin manually in DB
log in as super admin

Stop

make down

Test (light paths)

make check

Test (all paths)

make test-docker

Generate a migration

make migration msg=<msg>

See Makefile for more commands

Thanks for your patience and support

Acknowledgements