Substrate

A modern Copier template for scaffolding Python projects

Try it out on your own projects

Try it out

Try it out on your own projects

If you like it, give it a star on GitHub to support the project!

About Substrate

Substrate is a new template for scaffolding Python packages and apps with the following design goals:

Our MLOps Maturity Scan evaluates your team’s current maturity level and identifies key areas for improvement.

⏱️ Minimize the setup time of new Python projects

🧑‍💻 Make it easy to contribute to a project with one-click development environments

💅 Maximize code quality with linting checks & autofixes and static type analysis

✅ Follow industry best practices such as Conventional Commits, Semantic Versioning and Keep a Changelog

In short, we aim to help users of the template spend less time configuring & fixing ‘trivial’ things, like project structure, development environment, dependency management, collaborating with colleagues, ... in order to spend more time on valuable things, like applying their skills to the problem they’re trying to solve.

In short, we aim to help users of the template spend less time configuring & fixing ‘trivial’ things, like project structure, development environment, dependency management, collaborating with colleagues, ... in order to spend more time on valuable things, like applying their skills to the problem they’re trying to solve.

Why choose Substrate?

DevEx comes first

Substrate includes a suite of tools to ensure top-notch DevEx:

🖨️ Zero-effort project scaffolding and template updates with Copier

🧑‍💻 One-click development environments with Dev Containers and GitHub Codespaces

🐚 Modern shell prompt with Starship

📦 Packaging and dependency management with uv

⚡️ Task running with Poe the Poet

🧰 Dependency updates with Dependabot

Built-in best practices

With Substrate, your project is equipped with the industry-standard tools & practices for Python development from day one. Substrate integrates these tools out of the box with zero configuration required from your side:

✅ Code linting with Pre-commit, Mypy, and Ruff

💅 Code formatting with Ruff

🧪 Test coverage with Coverage.py

♻️ Continuous integration with GitHub Actions

🚦 Release new versions with Semantic Versioning and Keep A Changelog using Commitizen

Ready to get started?

Elevate your Python development with Substrate

Because your time is better spent innovating, not configuring!

Substrate is free to use. We’ve built it as the foundation for all our projects, and now we’re sharing it with the world. Dive into the full feature set and documentation on GitHub.

Try it out on your own projects

Try it out

Try it out on your own projects

If you like it, give it a star on GitHub to support the project!