Tutorial — Iroh
Peer-first model fetch
Pull an artifact from any Tenzro peer that already has it via iroh-blobs. Fall back to Hugging Face Hub if no peer is serving. Publish opportunistically on success.
- Level
- Intermediate
- Time
- ~10 min
- Prerequisites
- tenzro-node with iroh enabled
- Stack
- CLI + RPC
01
Enable iroh on your node
# config.toml
[iroh]
enable = true
# or
tenzro-node --role validator --iroh.enable02
Pull a model — peer-first
HfArtifactDownloader consults connected iroh peers via a PeerHint before reaching Hugging Face. If a peer has the BLAKE3 already, the transfer is end-to-end-verified over QUIC; if not, HF is the fallback.
tenzro model download timesfm-2.5 --prefer-peers03
Publish opportunistically
On successful HF fetch the downloader publishes the blob into the local iroh-blobs store. Subsequent fetchers on this or any peer node skip the HF round trip — the network warms itself.
04
Verify by URI
Any artifact resolved this way is reachable through the unified scheme — tenzro://blob/<blake3-hex> — regardless of which path supplied the bytes.