axm-init

Python project scaffolding, quality checks & governance CLI.

---

What it does

axm-init scaffolds production-grade Python projects with a single command. It generates fully configured projects with linting, typing, testing, CI/CD, and documentation out of the box.

Quick Example

$ axm-init scaffold my-project \
    --org axm-protocols --author "Your Name" --email "you@example.com"

✅ Project 'my-project' created at /path/to/my-project
   📄 pyproject.toml
   📄 src/my_project/__init__.py
   📄 tests/__init__.py
   📄 README.md

Features

• 🚀 Scaffold — Bootstrap projects with Copier templates (src/ layout, PEP 621)
• 📋 Check — Score any project against the AXM gold standard (44 checks, A–F grade)
• 📦 Reserve — Claim a package name on PyPI before you're ready to publish
• ✅ Standards — Pre-configured Ruff, MyPy, Pytest, GitHub Actions
• 📊 JSON output — Machine-readable output for CI integration

Learn More

• Quick Start Tutorial
• Scaffold a Project
• Check Project Quality
• Reserve a Name
• Use via MCP
• Architecture
• Check Grades
• CLI Reference