modern-python-boilerplate

My own python boilerplate for package developement

pythonboilerplate

Preview

modern-python-boilerplate preview

Overview

This is a Python project template that provides a standardized structure and tooling for building new Python packages. It includes dependency management with UV, code quality checks with Ruff and type checking with Ty, testing with Pytest, documentation generation with Mkdocs and deployment automation for PyPI, Docker and GitHub Pages, making it suitable for developers who want to follow modern Python best practices from project start.

Features

makefile-automationuv-package-managementruff-lintingruff-formattingtype-checking-with-mypypytest-testingcoverage-reportingpre-commit-hooksmkdocs-documentationapi-reference-generationdocker-supportdevcontainer-supportpypi-publishingtwine-publishing

Feature Flags

emailssearchaiapiDocsdocumentationtestingcidockerlintingtypeCheckingpreCommitHooks

Recommended Use Cases

python-library-developmentpython-package-developmentopen-source-projects

Frontend

None

Backend

python

Auth Providers

None

Deployment Targets

dockerpypi

Payment Providers

None

Quick Facts

โญ Stars
98
๐Ÿด Forks
10
๐Ÿ”„ Active
Unknown
๐Ÿ•’ Last Commit
2025-05-21T12:47:47.000Z

Stack

Language
python
Testing
pytest, pytest-cov
CI
github-actions, gitlab-ci

Data Layer

UI Stack

Developer Experience

Docker
Yes
Tests
Yes
Quickstart
Yes
env.example
No
CI
github-actions, gitlab-ci

Pricing

Classification
free
Selected
โ€”
Notes
Open source boilerplate template
Get Started with this Boilerplate