Skip to main content
fastapi-basekit

fastapi-basekit

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

PyPI Python FastAPI SQLAlchemy Beanie License

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 admin@example.com / 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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fastapi_basekit-0.5.0.tar.gz (109.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fastapi_basekit-0.5.0-py3-none-any.whl (97.8 kB view details)

Uploaded Python 3

File details

Details for the file fastapi_basekit-0.5.0.tar.gz.

File metadata

  • Download URL: fastapi_basekit-0.5.0.tar.gz
  • Upload date:
  • Size: 109.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for fastapi_basekit-0.5.0.tar.gz
Algorithm Hash digest
SHA256 165d02c8c586579a3c18e80f3eda6b056def1697382e38b9d4dcac8df5ef96ed
MD5 f129a570d7fad110d7885273f0807e91
BLAKE2b-256 ae631344dbce32438d7f8ebb8a677451b81ffc703687b570913bb79b71ada528

See more details on using hashes here.

Provenance

The following attestation bundles were made for fastapi_basekit-0.5.0.tar.gz:

Publisher: publish.yml on mundobien2025/fastapi-basekit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fastapi_basekit-0.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for fastapi_basekit-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 087fef4faea6f1fc59eecf74317a5a3cd242a1cedd434edada381c68ac023b19
MD5 0d7a2adde2cb34a98720d9a3f06c2f1e
BLAKE2b-256 834aa4680172d97dde4d95e47001913c09f63a1f772881c05864a3bfe3c08907

See more details on using hashes here.

Provenance

The following attestation bundles were made for fastapi_basekit-0.5.0-py3-none-any.whl:

Publisher: publish.yml on mundobien2025/fastapi-basekit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

This release

0.5.0 This release

2 files

0.4.3

2 files

0.4.1

2 files

0.4.0

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.1

2 files

0.2.0

2 files

0.1.25

2 files

0.1.24

2 files

0.1.23

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page