The most comprehensive Python project template that scales from simple libraries to enterprise applications
Transform any Python idea into a production-ready project in minutes. This CookieCutter template provides everything you need to build, test, deploy, and maintain modern Python applications with industry best practices baked in.
- Zero Configuration Hassle: Get a fully configured development environment instantly
- Production Ready: Battle-tested tools and patterns used in real-world applications
- Incredibly Flexible: Mix and match features to create exactly what you need
- Modern Standards: Uses the latest Python tooling and best practices
- Enterprise Grade: Scales from weekend projects to mission-critical applications
# Install cookiecutter if you haven't already
pip install cookiecutter
# Create your project
cookiecutter gh:tedivm/robs_awesome_python_templateAnswer a few questions about your project, and you'll have a complete Python application with everything configured and ready to go!
Every project created with this template includes these essential components:
Development Tools
- Makefile automation: One-command setup, testing, and deployment
- Modern pyproject.toml: No legacy setup.py files
- Virtual environment management: Automatic venv setup with pyenv integration
- Pre-commit hooks: Catch issues before they reach your repository
Code Quality
- Ruff: Lightning-fast formatting and linting
- mypy: Static type checking for safer code
- pytest: Comprehensive testing framework with async support
- Coverage reporting: Track your test coverage (even with multiprocess applications)
Configuration & Settings
- Pydantic Settings: Type-safe configuration management
- Environment-based config: Easy deployment across different environments
- Automatic validation: Catch configuration errors early
Publishing & Distribution
- setuptools-scm: Automatic versioning from git tags
- PyPI publishing: One-command package publishing
- Multi-architecture support: Works on AMD64 and ARM64
Pick and choose the features you need. Unused components are completely removed from your project.
FastAPI Integration
- Complete REST API setup with automatic documentation
- Static file serving
- Async request handling
- OpenAPI/Swagger UI included
- Production-ready ASGI configuration
Celery Integration
- Distributed task queue setup
- Redis broker configuration
- Worker and scheduler containers
- Monitoring and management tools
QuasiQueue Integration
- High-performance multiprocessing
- Simple async task processing
- Perfect for CPU-intensive workloads
- Async database operations
- Automatic model discovery
- Database migration management
- Support for PostgreSQL, SQLite, and more
- Connection pooling and optimization
Paracelsus Integration
- Automatic database schema diagrams
- Documentation generation
- Visual database relationships
- Beautiful CLI applications
- Automatic help generation
- Type-safe command definitions
- Async command support
- Auto-completion support
Jinja2 Templates
- Server-side rendering
- Template inheritance
- Custom filters and functions
Docker Setup
- Multi-service Docker Compose configuration
- Optimized multi-stage builds
- Development and production configurations
- Health checks and resource limits
- Multi-architecture image support from Multi-Py
Comprehensive GitHub Actions
- Automated testing across Python versions
- Code formatting and linting
- Type checking with mypy
- Security scanning
- Automated PyPI publishing
- Container image building and publishing
- Dependency updates with uv lockfile management
- Documentation generation and deployment
Agentic Instructions
- Pre-configured AGENTS.md with project-specific guidelines
- Best practices for AI coding assistants
- Context-aware development workflows
Every generated project includes extensive documentation:
- API Documentation: Auto-generated from code
- Development Guides: Database, caching, CLI, Docker setups
- Deployment Instructions: Production deployment strategies
The template intelligently configures itself based on your choices:
- Dependency management: Only includes what you need
- Docker services: Automatically sets up required containers
- Database connections: Configures based on selected databases
- CI/CD workflows: Enables relevant automation pipelines
- Settings management: Creates environment-specific configurations
Choose the license that fits your project:
- MIT License: Permissive, business-friendly
- BSD License: Simple and permissive
- Apache Software License 2.0: Patent protection included
- GNU General Public License v3: Copyleft for open source
- All Rights Reserved: Proprietary projects
See the template in action with complete example projects:
- Minimal setup for Python packages
- PyPI publishing ready
- Documentation and testing included
- Every feature enabled
- Complete web application with API, database, and task processing
- Production deployment ready
- Bare minimum configuration
- Perfect starting point for simple projects
Intelligent Cleanup
- Unused files and configurations are automatically removed
- No bloat or unnecessary dependencies
- Clean, focused project structure
Development Workflow
- One-command environment setup
- Automated testing and formatting
- Integrated debugging support
- Hot-reload for web applications
Production Ready
- Environment-based configuration
- Health checks and monitoring
- Optimized Docker containers
cookiecutter gh:tedivm/robs_awesome_python_templateYour next Python project is just one command away!