Fastapi Claude Template

FastAPI Template
Production-ready FastAPI template with Clean Architecture, multi-transport support (HTTP / NATS consumers / Taskiq scheduler), and first-class Claude Code integration — custom skills, architecture hooks, and a review agent that teach the AI how the codebase is structured.

A batteries-included starting point for building async Python services. Ships with the boring-but-important stuff already wired: Dishka DI across three transports, SQLAlchemy 2.0 async + Alembic, Pydantic v2 contracts, JWT auth, pagination, layered testing with testcontainers, and strict layer boundaries enforced by Claude Code hooks so the architecture stays clean as the project grows.

Highlights

- Clean Architecture + Hexagonal — strict inward dependencies (application/ → database/ is the only documented exception). The full ruleset lives in CLAUDE.md.
- Three transports, one composition root — HTTP (FastAPI + Granian), message consumers (FastStream over NATS), scheduled jobs (Taskiq over NATS JetStream). All share the same Dishka container built by entrypoints/container.py.
- RequestBus + UseCase pattern — every transport translates input into a Request, calls request_bus.send(), and unwraps a Result. Zero business logic in endpoints/subscribers/tasks. Paired with an EventBus for fire-and-forget domain events, both inheriting a shared Bus[M] Protocol.
- Audience-first HTTP routing — endpoints grouped by who can call them (public/, user/, admin/, internal/). Auth is wired once at the router level; it's structurally impossible to forget on individual endpoints.
- Strict/lenient pagination split — HTTP contract enforces 10 ≤ limit ≤ 200; internal callers can request unbounded fetches via limit=None.
- Layered testing — unit (mocks only), integration (testcontainers…