devstart 0.1.0

CLI tool that scaffolds Python projects with dev tooling pre-configured

DevStart

CLI tool that scaffolds Python projects with all dev tooling pre-configured.

Stop wasting time setting up ruff, mypy, pytest, Docker, CI, and pre-commit from scratch every time you start a new project. DevStart gives you a production-ready development environment in seconds.

Features

• src/ layout with hatch dynamic versioning (__version__ as single source of truth)
• Dev tooling out of the box: ruff (lint + format), mypy (strict), pytest, debugpy
• Docker & Docker Compose included by default
• GitHub Actions CI with pre-commit integration
• Devcontainer for consistent dev environments
• Pre-commit hooks: ruff, codespell, bandit, gitleaks, mypy, pytest
• PlantUML diagram templates for project documentation
• Makefile with setup, lint, format, test, check, and more
• Interactive or fully flag-driven project creation

Installation

uv tool install devstart

Or with pip:

pip install devstart

Quick Start

# Interactive — prompts for project details
devstart new myproject

# Non-interactive — use all defaults
devstart new myproject -y

# Scaffold into current directory
devstart new .

Usage

devstart new myproject \
  --description "My awesome project" \
  --author "Your Name" \
  --python 3.14 \
  --no-ci \
  --no-devcontainer \
  --no-precommit \
  --no-docker \
  --no-diagrams \
  -y

Flag	Default	Description
[NAME]	(prompted)	Project name (positional arg)
--description / -d	(prompted)	Project description
--author / -a	(prompted)	Author name
--python	3.14	Python version
--no-ci	false	Skip GitHub Actions CI
--no-devcontainer	false	Skip devcontainer setup
--no-precommit	false	Skip pre-commit hooks
--docker/--no-docker	true	Include Docker setup
--diagrams/--no-diagrams	true	Include PlantUML diagrams
--continue/--no-continue	true	Include Continue AI config
--no-interactive / -y	false	Use defaults, skip all prompts

Generated Project Structure

myproject/
├── src/myproject/
│   ├── __init__.py
│   ├── __main__.py
│   └── main.py
├── tests/
│   ├── __init__.py
│   ├── conftest.py
│   └── test_main.py
├── docker/                      # optional
│   ├── Dockerfile
│   └── docker-compose.yml
├── docs/                        # optional
│   └── diagrams/
│       └── class_diagram.puml
├── .vscode/
│   ├── launch.json
│   └── settings.json
├── .github/workflows/ci.yml    # optional
├── .devcontainer/               # optional
├── .pre-commit-config.yaml      # optional
├── pyproject.toml
├── README.md
├── Makefile
├── .gitignore
├── .dockerignore                # optional
└── .env

What You Get

Every generated project is immediately runnable:

cd myproject
make setup    # installs uv, syncs deps, sets up git + pre-commit
make check    # runs lint + format check + type check + tests
make test     # runs pytest
make format   # auto-formats with ruff

Contributing

git clone https://github.com/AymanKastali/DevStart.git
cd DevStart
make setup
make check

License

MIT