FastAPI Fastkit
<Open Source> Fast, easy-to-use starter kit for new users of Python and FastAPI
Ask AI about FastAPI Fastkit
Powered by Claude Β· Grounded in docs
I know everything about FastAPI Fastkit. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
FastAPI-fastkit: Fast, easy-to-use starter kit for new users of Python and FastAPI
This project was created to speed up the configuration of the development environment needed to develop Python-based web apps for new users of Python and FastAPI.
This project was inspired by the SpringBoot initializer & Python Django's django-admin CLI operation.
Key Features
- β‘ Immediate FastAPI project creation : Super-fast FastAPI workspace & project creation via CLI, inspired by
django-adminfeature of Python Django - β¨ Interactive project builder: Guided step-by-step feature selection for databases, authentication, caching, monitoring, and more with auto-generated code
- π¨ Prettier CLI output : Beautiful CLI experience powered by rich library
- π Standards-based FastAPI project templates : Templates follow Python standards and common FastAPI patterns.
- π Automated template quality assurance : Weekly automated testing ensures all templates remain functional and up-to-date
- π Multiple project templates : Choose from various pre-configured templates for different use cases (async CRUD, Docker, PostgreSQL, etc.)
- π¦ Multiple package manager support : Choose your preferred Python package manager (pip, uv, pdm, poetry) for dependency management
Installation
Install FastAPI-fastkit in your Python environment.
$ pip install FastAPI-fastkit
Usage
- Global options
--help: Show help--version: Show version--debug/--no-debug: Toggle debug mode
Create a new FastAPI project
fastkit init [OPTIONS]
- What it does: Scaffolds an empty FastAPI project, creates a virtual environment, installs dependencies
- Key options:
--project-name,--author,--author-email,--description--package-manager[pip|uv|pdm|poetry]- Stack selection:
minimal|standard|full(interactive)
Create a project with interactive mode
fastkit init --interactive
- What it does: Guided step-by-step project setup with intelligent feature selection
- Features:
- Architecture preset:
minimal|single-module|classic-layered|domain-starter(default) - Database selection: PostgreSQL, MySQL, MongoDB, Redis, SQLite
- Authentication: JWT, OAuth2, FastAPI-Users, Session-based
- Background tasks: Celery, Dramatiq
- Caching: Redis, fastapi-cache2
- Monitoring: Loguru, OpenTelemetry, Prometheus
- Testing: Basic (pytest), Coverage, Advanced (with faker, factory-boy)
- Utilities: CORS, Rate-Limiting, Pagination, WebSocket
- Deployment: Docker, docker-compose with auto-generated configs
- Package manager: pip, uv, pdm, poetry
- Custom packages: Add your own dependencies
- Architecture preset:
- Auto-generates (varies by preset β see the matrix for details):
main.pyregenerated from selected features forminimal/single-module; preserved as-shipped forclassic-layered/domain-starter- Database and authentication configuration files at preset-specific paths
- Docker deployment files (
Dockerfile,docker-compose.yml) with the preset's correct uvicorn entrypoint - Test configuration (pytest with coverage)
Create a project from a template
fastkit startdemo [TEMPLATE] [OPTIONS]
- What it does: Creates a project from a template (e.g.,
fastapi-default) and installs dependencies - Key options:
--project-name,--author,--author-email,--description--package-manager[pip|uv|pdm|poetry]
- Tip: List available templates with
fastkit list-templates
Add a new route
fastkit addroute <project_name> <route_name>
- What it does: Adds a new API route to the specified project
Run the development server
fastkit runserver [OPTIONS]
- What it does: Starts the uvicorn development server
- Key options:
--host,--port,--reload/--no-reload,--workers
List templates
fastkit list-templates
Delete a project
fastkit deleteproject <project_name>
Documentation
For comprehensive guides and detailed usage instructions, visit our documentation:
- π§ Which starter should I choose? - Beginner decision guide for
startdemotemplates and interactive presets - π User Guide - Detailed installation and usage guides
- π― Tutorial - Step-by-step tutorials for beginners
- π CLI Reference - Complete command reference
- π§± Architecture Preset Matrix - Per-preset / per-feature contract for interactive generation
- π Template Quality Assurance - Automated testing and quality standards
Contributing
We welcome contributions from the community! FastAPI-fastkit is designed to help newcomers to Python and FastAPI, and your contributions can make a significant impact.
Contributing Guide
Quick Start for Contributors
-
Fork and clone the repository:
git clone https://github.com/bnbong/FastAPI-fastkit.git cd FastAPI-fastkit -
Set up development environment:
make dev-setup # Sets up everything you need -
Run development checks:
make dev-check # Format, lint, and test
What You Can Contribute
- π New FastAPI templates - Add templates for different use cases
- π Bug fixes - Help us improve stability and reliability
- π Documentation - Improve guides, examples, and translations
- π§ͺ Tests - Increase test coverage and add integration tests
- π‘ Features - Suggest and implement new CLI features
Contribution Guidelines
For detailed contribution guidelines, development setup, and project standards, please refer to:
- CONTRIBUTING.md - Comprehensive contribution guide
- CODE_OF_CONDUCT.md - Project principles and community standards
- SECURITY.md - Security guidelines and reporting
Significance of FastAPI-fastkit
FastAPI-fastkit aims to provide a fast and easy-to-use starter kit for new users of Python and FastAPI.
This idea was initiated with the aim of helping FastAPI newcomers learn from the beginning, which aligns with the production significance of the FastAPI CLI package added with the FastAPI 0.111.0 version update.
As someone who has been using and loving FastAPI for a long time, I wanted to develop a project that could help fulfill the wonderful motivation that FastAPI developer tiangolo has expressed.
FastAPI-fastkit bridges the gap between getting started and building production-ready applications by providing:
- Immediate productivity for newcomers who might be overwhelmed by setup complexity
- Best practices built into every template, helping users learn proper FastAPI patterns
- Scalable foundations that grow with users as they advance from beginners to experts
- Community-driven templates that reflect real-world FastAPI usage patterns
License
This project is licensed under the MIT License - see the LICENSE file for details.
