Python · uv-powered · headless

Replace the scripts. One CLI does it all.

Universal, headless Python wheel builder supporting local paths, git repos, and CI/CD pipelines.

Install

# pip or uv pip install headless-wheel-builder # with all extras pip install headless-wheel-builder[all]

Build & release

# build from anywhere hwb build https://github.com/user/repo@v2.0.0 # draft release with approval workflow hwb release create -v 1.0.0 -p my-package --template two-stage hwb release submit rel-abc123 hwb release approve rel-abc123 -a alice hwb release publish rel-abc123

Pipeline

# run a complete build-to-release pipeline hwb pipeline run my-pipeline.yml # generate GitHub Actions workflow hwb actions generate ./my-project --output .github/workflows/ci.yml # coordinate releases across repos hwb multirepo release --tag v2.0.0

Beyond python -m build

Everything after the build step — release workflows, dependency analysis, security scanning — in one tool.

Build from anywhere

Local paths, git URLs with branch or tag, tarballs, multi-platform matrices. venv (uv-powered, 10-100x faster) or Docker (manylinux/musllinux).

Approval workflows

Draft releases, multi-stage approval (simple, two-stage, or enterprise QA → Security → Release), auto-changelog from Conventional Commits.

Security & compliance

Dependency graph analysis, license compliance checks, SBOM generation (CycloneDX), vulnerability scanning, and build metrics dashboard.

CLI reference

Every pipeline step, one command.

Command

What it does

hwb build

Build wheels from local path, git URL, or tarball

hwb publish

Publish to PyPI, TestPyPI, private registries, or S3

hwb release

Draft, approve, and publish releases with approval workflows

hwb pipeline

Orchestrate build → test → release → publish pipelines

hwb deps

Dependency graph analysis and license compliance checks

hwb security

SBOM generation, vulnerability detection, license auditing

hwb github

Headless GitHub: releases, PRs, issues, workflow triggers

hwb multirepo

Build and coordinate releases across multiple repositories

hwb metrics

Build performance tracking, success rates, cache hit analytics

hwb cache

LRU artifact cache management with registry integration

Get started

Install

pip install headless-wheel-builder
# or with uv (recommended)
uv pip install headless-wheel-builder

Build from git

hwb build https://github.com/user/repo@v2.0.0 \
  --isolation docker \
  --python 3.11 --python 3.12

Security audit

hwb security audit ./my-project
hwb security sbom ./my-project --format cyclonedx
hwb deps licenses numpy --check

Python API

from headless_wheel_builder import build_wheel

result = await build_wheel(
  source=".",
  output_dir="dist",
  python="3.12",
)
print(f"Built: {result.wheel_path}")

How it works

A complete wheel lifecycle — from source to shipped — with no web UI required.

1. Build

Point hwb at any source — local directory, git URL, or tarball. It creates an isolated venv or Docker container and builds your wheels.

2. Review & approve

Draft a release, run it through your approval workflow, generate a changelog, and sign off — all from the CLI.

3. Publish & notify

Push to PyPI, private registries, or S3. Notify Slack, Discord, or Teams. Track metrics. Cache artifacts for the next run.