Skip to content

feat(hf): Hugging Face org mirror pipeline (riboseinc/<id>) - #241

Merged
ronaldtse merged 7 commits into
mainfrom
feat/hf-mirror
Oct 5, 2026
Merged

ronaldtse merged 7 commits into
mainfrom
feat/hf-mirror

Conversation

@ronaldtse

Copy link
Copy Markdown
Contributor

The HF channel from the distribution plan, made real: riboseinc/<index-id> mirrors with generated model cards.

  • scripts/model_card.py — models.yaml entry -> HF README (YAML frontmatter: license/language/inference:false + secryst/transliteration/diacritization/onnx/byt5 tags; metrics table WITH provenance links; curated benchmark block wrapper). TDD, 8 tests.
  • scripts/publish_hf.py — per-id CLI: assembled artifact zip + generated card -> riboseinc/<id>; --dry-run prints the full plan without network; HF_TOKEN from the environment (fine-grained, write-scoped — to be added as a repo secret).
  • cards/ara-diac-2.0.md — the flagship curated block: SadeedDiac-25 leaderboard (2.29% DER, best dedicated), architecture, provenance statement.

To go live (owner): add the HF_TOKEN Actions secret on this repo, then python3 scripts/publish_hf.py --id ara-diac-2.0 --zip <assembled fp32>. Phase 2: remaining 20 index ids; phase 3: plane family (ara-diac-plane-1.0) after the run-019 verdict.

Ronald Tse added 7 commits October 5, 2026 09:37
- model_card.py: models.yaml entry -> HF README (frontmatter, metrics
  table with provenance, curated benchmark block wrapper) - TDD, 8 tests
- publish_hf.py: per-id CLI (assembled zip + generated card ->
  riboseinc/<id>), dry-run mode, HF_TOKEN from env, classes.json side
  path for plane artifacts
- cards/ara-diac-2.0.md: the flagship curated block (SadeedDiac-25
  leaderboard, architecture, provenance)

User actions to go live: fine-grained HF token (write to the model
repos) as the HF_TOKEN secret on this repo, then
python3 scripts/publish_hf.py --id ara-diac-2.0 --zip <assembled>
- assemble_release.py: index parts -> artifact, per-part + whole-file
  sha256 verification (TDD, 3 tests incl. part-mismatch rejection)
- publish_hf: verifies the local zip against the index sha before upload
- hf-publish.yml: workflow_dispatch (id input) -> assemble -> publish
  with the HF_TOKEN org secret; uploads become
  gh workflow run hf-publish.yml -f id=ara-diac-2.0
@ronaldtse
ronaldtse merged commit 2b3b984 into main Oct 5, 2026
10 checks passed
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