fastapi-basekit 0.4.0

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

Dentro de Claude Code (terminal) corre:

/plugin marketplace add mundobien2025/fastapi-basekit
/plugin install fastapi-basekit@fastapi-basekit
/plugin list                                       # verifica instalación

Eso registra el marketplace fastapi-basekit desde el repo de GitHub e instala el plugin (que incluye la skill fastapi-basekit-crud). Luego pide: "Crea el recurso Invoice con CRUD completo siguiendo fastapi-basekit" — Claude detecta la skill y aplica el patrón canónico (model → repo → service → schema → controller con @cbv).

Para actualizar a una versión nueva:

/plugin update fastapi-basekit@fastapi-basekit

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.

Licencia

MIT — © Jerson Moreno