Metadata-Version: 2.4
Name: inferencebench-hf-publisher
Version: 0.0.2
Summary: Publish signed InferenceBench envelopes to the Hugging Face Hub as datasets
Project-URL: Homepage, https://github.com/yobitelcomm/bench
Project-URL: Documentation, https://yobitelcomm.github.io/bench/integrations/hf-publisher
Author-email: Yobitel Communications <bench@yobitel.com>
License: Apache-2.0
Keywords: ai,benchmark,hf-hub,huggingface,inferencebench,ml
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.12
Requires-Dist: huggingface-hub<1.0,>=0.30
Requires-Dist: inferencebench-envelope
Requires-Dist: pydantic~=2.9
Description-Content-Type: text/markdown

# inferencebench-hf-publisher

Publishes signed InferenceBench envelopes to the [Hugging Face Hub](https://huggingface.co/) as dataset repos under the `Yobitel` organisation. This is the public, citable, verifiable home of every result emitted by `bench publish --to hf`.

## Status

Phase 1 active development. Tickets 0029-0030.

## What it does

1. Slugifies the envelope's model id, suite id, and run hash into a deterministic dataset repo id.
2. Uploads `envelope.json`, optional `traces.parquet`, and a generated `README.md` with YAML frontmatter (the HF dataset card).
3. Optionally appends a backlink entry to the source model card's metadata (never modifies the visible body).

See [skills/hf-publishing/SKILL.md](../../skills/hf-publishing/SKILL.md) for the full design.

## Quick start

```python
from inferencebench_hf_publisher import publish_envelope_to_hf

result = publish_envelope_to_hf(envelope, hf_token=os.environ["HF_TOKEN"])
print(result.url)
```

Pass `dry_run=True` to compute the planned URL without hitting HF Hub — useful in tests and CI smoke runs.
