Skip to content

About

A starting point for Python projects, with dependency management, formatting, type checking, and testing tools already configured.

Topics

Resources

Code of conduct

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

python-project-template

Docs Sponsor License

Production-ready Python devcontainer template focused on speed, consistency, and team workflows.

Features

  • 🌍 Platform-independent development with Dev Containers
  • 🧩 Host isolation: no local Python/toolchain setup required
  • ⚙️ Auto bootstrap on container create (scripts/setup.sh)
  • 🛠️ Runtime + task management with mise
  • ⚡ Fast Python workflow with uv, ruff, ty, and pytest
  • ✅ CI quality gates (lint, format, type checks, tests, coverage)
  • 🔒 Pre-commit + commit-msg hooks with Conventional Commit support
  • 🔁 Dependabot automation for dependencies and GitHub Actions
  • 🤖 AI-agent-ready guidance via AGENTS.md and repo skills
  • 📚 Docs pipeline with zensical + GitHub Pages deploy

Quick Start (Dev Container)

Prerequisites: Docker + VS Code with the Dev Containers extension.

# Clone the template
git clone https://github.com/HYP3R00T/python-project-template.git

# Enter the project folder
cd python-project-template

# Open in VS Code
code .

Then run: Dev Containers: Reopen in Container from the VS Code Command Palette.

About

A starting point for Python projects, with dependency management, formatting, type checking, and testing tools already configured.

Topics

Resources

Code of conduct

Stars

0 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages