Headless Wheel Builder Handbook
Headless Wheel Builder replaces a patchwork of build scripts, release tooling, and CI glue with a single CLI. Build wheels from local paths, git URLs, or tarballs. Draft releases with multi-stage approval workflows. Scan dependencies for vulnerabilities. Generate changelogs. Publish everywhere.
What you will find here
Section titled “What you will find here”- Getting Started — Install, build your first wheel, configure multi-platform builds.
- Release Management — Draft releases, approval workflows, rollback, changelog generation.
- CLI Reference — All 14 commands at a glance.
- DevOps — Pipelines, GitHub Actions, multi-repo operations, notifications, metrics.
- Security — Vulnerability scanning, SBOM generation, license compliance, dependency analysis.
Why one tool?
Section titled “Why one tool?”Most Python packaging workflows involve a fragile chain: a build backend, a separate publisher, a changelog generator, a release manager, maybe a security scanner. When something breaks, you are debugging five tools at once.
Headless Wheel Builder unifies the entire wheel lifecycle — from source to shipped — into a single, headless CLI that works identically on your laptop and in CI.