Un framework web de Python para crear APIs con anotaciones de tipos estándar, validación automática, documentación OpenAPI y alto rendimiento.
103,3 mil10,1 milPythonMITActualizado anteayer
zhanymkanov/fastapi-best-practices
Buenas prácticas y convenciones con criterios definidos para crear aplicaciones FastAPI listas para producción, basadas en la experiencia en startups.
- Estrellas
- 18,217
- Forks
- 1,329
- Issues abiertos
- 16
- Último commit
- hace 2 meses
¿Qué es?
Esta guía reúne convenciones con criterios definidos para crear backends FastAPI en producción. Explica cómo estructurar un monolito con muchos dominios, cuándo usar rutas y dependencias async o sync, cómo organizar los modelos y la configuración de Pydantic, y cómo encadenar dependencias para validar y reutilizar lógica.
También aborda temas de datos y herramientas: diseño de consultas SQL-first, reglas para las migraciones de Alembic, convenciones para nombrar elementos de la base de datos, cuándo usar BackgroundTasks en lugar de una cola de tareas real, cómo controlar la visibilidad de la documentación de la API y cómo escribir pruebas de integración async con httpx y overrides de dependencias. La mayoría de las secciones incluye ejemplos de código.
El contenido está dirigido a desarrolladores de Python que ya conocen FastAPI y buscan orientación para mantener una estructura de proyecto clara y evitar errores habituales, como bloquear el event loop o usar BackgroundTasks de forma inadecuada. El archivo complementario AGENTS.md presenta las mismas reglas en un formato legible por máquinas para agentes de programación con IA.
Funciones clave
- 01Orientación para organizar un monolito en módulos por dominio.
- 02Explicaciones sobre cuándo se ejecutan las rutas y dependencias sync y async en un threadpool.
- 03Patrones para encadenar y almacenar en caché dependencias que validan solicitudes.
- 04Convenciones de Pydantic, como un modelo base personalizado y la separación de BaseSettings.
- 05Orientación sobre consultas SQL-first, migraciones de Alembic y convenciones para nombrar elementos de la base de datos.
- 06Configuración de pruebas con clientes async de httpx y dependency_overrides, además de ruff para linting y formateo.
Casos de uso
- Estructurar un monolito FastAPI en crecimiento con muchos dominios y módulos.
- Incorporar desarrolladores a las convenciones de FastAPI de un equipo.
- Revisar las decisiones entre async y sync para evitar bloquear el event loop.
- Proporcionar reglas de FastAPI coherentes a agentes de programación con IA mediante AGENTS.md.
Antes de usarlo
- No se especifica ninguna licencia en los metadatos del proyecto.
Temas
Preguntas frecuentes
- ¿Qué es fastapi-best-practices?
- Buenas prácticas y convenciones con criterios definidos para crear aplicaciones FastAPI listas para producción, basadas en la experiencia en startups. Esta guía reúne convenciones con criterios definidos para crear backends FastAPI en producción. Explica cómo estructurar un monolito con muchos dominios, cuándo usar rutas y dependencias async o sync, cómo organizar los modelos y la configuración de Pydantic, y cómo encadenar dependencias para validar y reutilizar lógica.
- ¿fastapi-best-practices es gratuito? ¿Qué licencia tiene?
- fastapi-best-practices no declara ninguna licencia. Su código es público, pero sin licencia no tienes permiso explícito para reutilizarlo; consulta al autor antes de depender de él.
- ¿fastapi-best-practices sigue mantenido?
- Actualizado en los últimos 6 meses. El último commit de fastapi-best-practices fue el 27 ago 2026.
- ¿Para qué puedo usar fastapi-best-practices?
- Estructurar un monolito FastAPI en crecimiento con muchos dominios y módulos. Incorporar desarrolladores a las convenciones de FastAPI de un equipo. Revisar las decisiones entre async y sync para evitar bloquear el event loop. Proporcionar reglas de FastAPI coherentes a agentes de programación con IA mediante AGENTS.md.
- ¿Dónde consigo fastapi-best-practices?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/zhanymkanov/fastapi-best-practices
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Plataforma multiagente sin código: define agentes, flujos de trabajo y tareas con YAML y una consola web para crear software y otros resultados.
34,6 mil4,3 milPythonApache-2.0Actualizado hace 5 días
La biblioteca oficial de Python para la API REST de OpenAI, con clientes síncronos y asíncronos y modelos tipados para solicitudes y respuestas.
31,9 mil8,5 milPythonApache-2.0Actualizado ayer
Framework de Python para crear interfaces web y aplicaciones pequeñas en el navegador, sin escribir HTML, CSS ni JavaScript.
16,3 mil964PythonMITActualizado hace 15 horas
Un framework y toolkit ASGI ligero para crear servicios web asíncronos y APIs en Python.
12,7 mil1,4 milPythonBSD-3-ClauseActualizado hace 3 días
Biblioteca cliente oficial de Python para usar los modelos locales y en la nube de Ollama mediante APIs de chat, generación, embeddings y gestión de modelos.
10,6 mil1,2 milPythonMITActualizado hace 5 días