Skip to content

Python Boilerplate

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

Overview

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.

✨ Why Use These Templates?

  • ⚡ 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

Available Templates

🚀 UV Template

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

Repository & Documentation

📂 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

📦 Poetry Template

Classic Python project template using Poetry for dependency management.

Repository & Documentation

📂 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

🛠️ 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

Quick Start

Getting Started

  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! 🎉

Templates Comparison

Feature UV Template Poetry Template
Package Manager uv (ultra-fast) Poetry (mature)
Dependency Locking ✅ uv.lock ✅ poetry.lock
Python Version Management ✅ Built-in ❌ External tool needed
Speed ⚡ Fastest 🐌 Slower
Ecosystem Maturity 🆕 New but growing 🏆 Well-established
Learning Curve 📈 Minimal 📊 Moderate

Documentation & Resources

Contributing

Want to Contribute?

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

Support

Need Help?

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

License

All templates are released under the MIT License.

Made with ❤️ by @monok8i

⭐ Follow the Organization • 📋 Browse Templates • 💬 Join Discussions