OpenWeights documentation
A Hugging Face-compatible model hub that stores your bytes on the Sia network.
OpenWeights is a self-hostable model hub. You point the standard Hugging Face
hf CLI at your own OpenWeights deployment, and the files you upload are stored
on the Sia decentralized storage network. The CLI is unmodified: no fork of
huggingface_hub, no patched hf_xet wheel.
Pick your path
Three short quickstarts, one per way of using OpenWeights. Each links on to the detailed pages.
Self-host for yourself
Run it on your own machine, just for you, with a password login.
Operate for a team
Run it for others, with GitHub sign-in and a real domain.
Use an existing deployment
Someone else runs it — upload and download with the hf CLI.
Or browse the full docs
Using OpenWeights
Run the stack, sign in, mint an API key, and upload and download models with the hf CLI.
How it works
Architecture, the Xet protocol implementation, the HTTP API reference, and every configuration knob.
Start here
If you have never run OpenWeights before, self-hosting for yourself takes you from an empty directory to a byte-identical upload and download.
If you want to know what happens between hf upload and bytes landing on Sia
hosts, start with the architecture.