A collection of modern Python project templates with pre-configured development tools, CI/CD pipelines, and best practices.

Python Boilerplate is a curated collection of project templates designed to help developers quickly bootstrap new Python projects with industry best practices and modern tooling already configured.

• ⚡ Fast Setup - Get a production-ready project structure in seconds
• 🛠️ Modern Tooling - Pre-configured linters, formatters, type checkers, and testing frameworks
• 🚀 CI/CD Ready - Automated workflows for GitHub Actions
• 🐳 Docker Support - Development and production containerization
• 📚 Documentation - MkDocs integration with Material theme
• 🔧 Developer Experience - Pre-commit hooks, Makefile automation, and dev containers

Modern Python project template using uv - the ultra-fast Python package manager.

📂 uv-template | 📖 Documentation

🎯 Core Features:

• 🐍 Python 3.10+ - Modern Python version support
• ⚡ uv - Ultra-fast Python project manager with dependency installer and lock file support
• 🐳 Docker Support - Multi-stage Dockerfiles for easy local development and clean production containers
• 🔄 GitHub Actions CI/CD - Automated linting, testing, static analysis, and security checks for every branch
• 💻 Dev Containers - Ready-to-use development environment in GitHub Codespaces or VSCode Remote Containers

🛠️ Code Quality Tools:

• 🔍 Ruff - Built-in linting and formatting
• 🔎 MyPy - Static type checking
• 🧪 Pytest - Testing framework with async support
• 📊 Vermin - Minimum Python version analysis

⚙️ Developer Experience:

• 🎣 Pre-commit Hooks - Runs linters, formatting, and tests automatically before every commit
• 📝 Commitizen - Standardized commit messages with automated versioning and changelog updates
• 🌍 Environment Management - Stage-based environment variable configuration for dev/prod with switching via APP_STAGE
• 📖 MkDocs Documentation - Project documentation generated with MkDocs and the Material theme
• 🔧 Makefile Automation - Common tasks available as simple Makefile commands

Classic Python project template using Poetry for dependency management.

📂 poetry-template | 📖 Documentation

🎯 Core Features:

• 🐍 Python 3.10+ - Modern Python version support
• 📦 Poetry - Mature dependency management with lock files
• 🐳 Docker Support - Containerization for development and production
• 🔄 CI/CD Pipelines - Automated quality checks and deployment workflows
• 📚 Structured Documentation - Well-organized project documentation

1. Choose your template from the list above
2. Use as GitHub Template - Click "Use this template" button on the repository page
3. Clone your new repository

   git clone https://github.com/your-username/your-project-name.git
   cd your-project-name

4. Initialize the project

   make init

5. Start developing! 🎉

• GitHub Organization - All templates and repositories
• UV Template Docs - Complete uv template documentation
• Poetry Template Docs - Complete poetry template documentation

We welcome contributions! If you have ideas for improvements or new templates:

1. Open an issue to discuss your idea
2. Fork the repository and make your changes
3. Submit a pull request with a clear description

• 📋 Issues - Report bugs or request features in the specific template repository
• 💬 Discussions - Ask questions in GitHub Discussions
• 📧 Contact - Reach out to @monok8i

All templates are released under the MIT License.