Skip to content

docs: track headroom 0.25.0 (abi3 Python support) and document HF_TOKEN#8

Merged
lkosewsk merged 1 commit into
mainfrom
lk/headroom-0.25.0-readme-updates
Jun 12, 2026
Merged

docs: track headroom 0.25.0 (abi3 Python support) and document HF_TOKEN#8
lkosewsk merged 1 commit into
mainfrom
lk/headroom-0.25.0-readme-updates

Conversation

@lkosewsk

Copy link
Copy Markdown
Collaborator

headroom-ai 0.25.0 ships an abi3 (stable-ABI) wheel built for py310, so a single wheel now covers Python 3.10+ including 3.14 — the README's "3.14 has no wheel, falls back to Rust source build" guidance is stale. Reframe the requirements, install steps, and troubleshooting around the new floor (interpreter older than 3.10, or a wheel-less platform).

Add an HF_TOKEN (optional) section explaining the HuggingFace Hub token: what it's for (model download auth / anonymous per-IP rate limits on a cold-starting worker pool), when a self-hoster wants one, and how to get and wire one in.

headroom-ai 0.25.0 ships an abi3 (stable-ABI) wheel built for py310,
so a single wheel now covers Python 3.10+ including 3.14 — the README's
"3.14 has no wheel, falls back to Rust source build" guidance is stale.
Reframe the requirements, install steps, and troubleshooting around the
new floor (interpreter older than 3.10, or a wheel-less platform).

Add an HF_TOKEN (optional) section explaining the HuggingFace Hub token:
what it's for (model download auth / anonymous per-IP rate limits on a
cold-starting worker pool), when a self-hoster wants one, and how to get
and wire one in.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Luke Kosewski <lkosewsk@tailscale.com>
@lkosewsk lkosewsk merged commit 7a82264 into main Jun 12, 2026
2 checks passed
@lkosewsk lkosewsk deleted the lk/headroom-0.25.0-readme-updates branch June 12, 2026 23:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant