fastapi-basekit 0.3.1

Utilities and base classes for FastAPI async projects (Beanie, SQLAlchemy or SQLModel)

fastapi-basekit

FastAPI toolkit con repos, services y controllers listos para producción. Multi-ORM · CLI scaffolder · plugin Claude Code.

Docs · PyPI · Issues · Changelog

---

Quickstart

pip install fastapi-basekit[init]
basekit init                                    # cookiecutter prompts
cd <project_slug>
cp .env.example .env
make up-d
make migrate-create && make migrate-up
make seed

Abre http://localhost:8000/docs. Login con [e-mail] / ChangeMe2026!.

¿Qué incluye?

• Repository / Service / Controller base async para SQLAlchemy 2.0, SQLModel y Beanie
• Paginación, filtrado, búsqueda, ordenamiento vía query string out-of-the-box
• JWT middleware + BasePermission classes + soft-delete
• basekit init — scaffolder cookiecutter (multi-ORM, multi-DB, redis, s3, license)
• Plugin Claude Code — la skill fastapi-basekit-crud enseña el patrón a Claude

Documentación

mundobien2025.github.io/fastapi-basekit

Sección	Contenido
Primeros pasos	Instalación, basekit init, primer CRUD
Guía de usuario	Controllers, services, repositories, paginación, filtros
Avanzado	Permisos, soft-delete, logging, performance
Referencia API	Docstrings de BaseController, BaseService, BaseRepository, Schemas
Ejemplos	CRUD básico, filtros complejos, relaciones, auth

Como plugin de Claude Code

/plugin marketplace add https://github.com/mundobien2025/fastapi-basekit
/plugin install fastapi-basekit
/plugin list

Luego pide: "Crea el recurso Invoice con CRUD completo" — Claude usa la skill automáticamente.

Instalación por ORM

pip install fastapi-basekit[sqlalchemy]   # Postgres / MySQL / SQLite
pip install fastapi-basekit[beanie]       # MongoDB
pip install fastapi-basekit[sqlmodel]
pip install fastapi-basekit[init]         # solo scaffolder
pip install fastapi-basekit[all]          # todo

Contribuir

PRs bienvenidos. Setup local en docs/contributing.

Mantenedores: RELEASING.md tiene release flow, CI/CD, mike y troubleshooting.

Licencia

MIT — © Jerson Moreno