python-fastapi-template

A simple and idiomatic REST API boilerplate in Python using FastAPI, designed for clarity, modularity and extensibility.
Built to showcase best practices in Python backend development and serve as a solid foundation for future projects.

✨ Features

• 🧱 Modular project structure (api/, models/, services/, etc.)
• 🔀 Routing with versioned endpoints
• 📄 OpenAPI docs auto-generated (/docs, /redoc)
• ✅ Data validation and typing with Pydantic v2
• 🧪 Async-ready test setup with pytest, httpx, pytest-asyncio
• 🐳 Minimal Docker support
• 🧰 Designed as a reusable starter template

📦 Technologies

• Python 3.13+
• FastAPI
• Uvicorn (ASGI server)
• Pydantic v2

🚀 Getting Started

# Install dependencies
poetry install

# Run the development server
poetry run uvicorn app.main:app --reload --log-config=log_config.yml