benavlabs /
SQLModel-boilerplate
An extendable async API using FastAPI, SQLModel, PostgreSQL and Redis.
81/100 healthRecently updatedActive repository
PythonMIT#alembic#api#arq#async
⑂ 26 forks◯ 3 issuesUpdated 1 day ago
Loading repository data…
Loading repository data…
benavlabs / repository
An extendable async API using FastAPI, Pydantic V2, SQLAlchemy 2.0, PostgreSQL and Redis.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
@cache decorator + provider API)bp CLI - generate compose files, audit env, mount third-party command/feature pluginsPerfect if you want:
Not a fit if you need a monorepo microservices scaffold - see the docs for pointers.
What you get:
bp tool for compose scaffolding, env audits, and plugin extensionsThis boilerplate - Fastro - is the free, open-source foundation: everything you need for a production FastAPI backend. FastroAI is the paid template built on the same foundation for shipping a complete SaaS - Stripe billing (subscriptions, credits, discounts), entitlements, transactional email, and a frontend, all wired together. Building an AI product? The PydanticAI agent layer is included too - but every paid feature fits a regular SaaS just as well.
| Fastro (this repo · free) | FastroAI (paid) | |
|---|---|---|
| FastAPI + SQLAlchemy 2.0, Pydantic v2 | ✓ | ✓ |
| Auth - sessions, OAuth, API keys | ✓ | ✓ + JWT |
| FastCRUD · SQLAdmin · Alembic | ✓ | ✓ |
| Caching · rate limiting · Taskiq jobs | ✓ | ✓ |
| Docker (local / prod / nginx) | ✓ | ✓ |
bp CLI - scaffolding, env audit, plugins | ✓ | |
| Payments - Stripe: subscriptions, credits, discounts, webhooks | ✓ | |
| Entitlements - feature gating by plan/tier | ✓ | |
| Transactional email & notifications | ✓ | |
| Frontend - Astro landing / marketing site | ✓ | |
| Observability - Logfire tracing & metrics | ✓ | |
| AI agents - PydanticAI: memory, tools, usage tracking | ✓ | |
| Support | Community · Discord | Priority · lifetime updates |
Stick with Fastro if you want a clean, hackable FastAPI backend to build on. Get FastroAI → if you're shipping a SaaS - AI or not - and want billing, entitlements, email, auth, and a frontend ready out of the box.
This is a uv workspace with two members. One venv at the root covers both.
fastapi-boilerplate/
├── pyproject.toml # workspace root (uv workspace metadata)
├── backend/ # the deployable application
│ ├── src/ # interfaces/, infrastructure/, modules/
│ ├── pyproject.toml
│ └── Dockerfile # multi-stage: dev / migrate / prod
└── cli/ # `bp` - developer/operator tool (never ships in prod)
└── src/cli/
git clone https://github.com/<you>/FastAPI-boilerplate
cd FastAPI-boilerplate
uv sync --all-packages --all-extras # one venv at the root, both members installed
Generate a compose file for the deployment shape you want:
uv run bp deploy generate local # hot-reload dev stack
# or: uv run bp deploy generate prod # production single-host
# or: uv run bp deploy generate nginx # production behind nginx
Configure your env (the CLI helps with secrets and validation):
cp backend/.env.example backend/.env
uv run bp env gen-secret # print a fresh SECRET_KEY
uv run bp env validate # audit .env against the production validator
Bring it up:
docker compose up --build
# → http://127.0.0.1:8000 (Swagger at /docs)
Without Docker (Postgres + Redis required locally):
cd backend
uv run alembic upgrade head
uv run python -m scripts.setup_initial_data # creates the first admin user + default tier
uv run fastapi dev src/interfaces/main.py # API
uv run taskiq worker infrastructure.taskiq.worker:default_broker # in a second terminal
Full setup, env-var reference, and per-environment deployment guides live in the docs.
# generate a fresh production-ready compose file
uv run bp deploy generate prod --workers 8
# audit your .env against the production security validator
uv run bp env validate
# run Alembic migrations
cd backend && uv run alembic revision --autogenerate -m "<msg>" && uv run alembic upgrade head
# run tests
cd backend && uv run pytest
# install bp as a global tool (optional)
uv tool install --editable ./cli
More examples (superuser creation, tiers, rate limits, admin usage, plugin authoring) in the docs.
Read contributing.
This project was inspired by a few projects, it's based on them with things changed to the way I like (and pydantic, sqlalchemy updated)
Full Stack FastAPI and PostgreSQL by @tiangolo himselfFastAPI Microservices by @kludex which heavily inspired this boilerplateAsync Web API with FastAPI + SQLAlchemy 2.0 for sqlalchemy 2.0 ORM examplesFastaAPI Rocket Boilerplate for docker composeBenav Labs – benav.io, discord server
Selected from shared topics, language and repository description—not editorial ratings.
benavlabs /
An extendable async API using FastAPI, SQLModel, PostgreSQL and Redis.
81/100 health