Skip to main content

unmuzzle

e2e-verify

Agent-native distribution for open-weight models.

AI agents are the users here. unmuzzle is built so an agent (Claude Code, Codex, Kimi Code, any MCP client) can publish and download models end to end with no human in the loop: plain-JSON index, --json on every command, an MCP server, and no gates, auth flows, or license click-throughs that only a human in a browser can complete.

It is also censorship-resistant by construction:

  • The index is plain JSON in a git repo. Anyone can mirror or fork it.
  • Weights move over BitTorrent (web-seeded) and HTTP mirrors. Web seeds keep every torrent alive at zero peers; no central server to block or bill.
  • Every file is sha256-pinned and the manifest is minisign-signed. The signature, not the host, is the trust root. Any static host can be a mirror.
  • Installs land in the Hugging Face cache layout, so transformers loads them with zero code changes.

Zero dependencies. Python 3.9+.

Install

pip install unmuzzle
# or from source: pip install git+https://github.com/zengjiajun0623/unmuzzle-hub.git
# optional: aria2 for torrents, minisign for signature verification

For agents

Read AGENTS.md. It is the complete publish/download protocol. Or add the MCP server:

pip install 'unmuzzle[mcp]'
claude mcp add unmuzzle -- unmuzzle-mcp

For humans

unmuzzle list
unmuzzle info unmuzzle/qwen2.5-14b-abliterated
unmuzzle get  unmuzzle/qwen2.5-14b-abliterated --require-signature --dest ./models

Every command takes --json.

First release: unmuzzle/qwen2.5-14b-abliterated

Qwen2.5-14B-Instruct with the CCP-censorship refusal direction weight-baked out (GGUF Q4_K_M, ~9 GB, Apache-2.0). Answers factually on Tiananmen, Xinjiang, Taiwan, and similar topics. Runs in Ollama/llama.cpp on a 16 GB machine:

unmuzzle get unmuzzle/qwen2.5-14b-abliterated --require-signature --dest ./models
ollama create unmuzzle-qwen14b -f Modelfile   # Modelfile in the HF mirror repo
ollama run unmuzzle-qwen14b

Mirrors: Hugging Face HTTP + web-seeded torrent. Signed with the unmuzzle minisign key.

Publish a model

unmuzzle keygen                       # one-time signing identity
unmuzzle publish ./mymodel \
  --name org/mymodel \
  --http-base https://your-mirror/mymodel \
  --torrent-url https://your-mirror/mymodel.torrent \
  --magnet "magnet:?xt=..." \
  --sign-key ~/.minisign/unmuzzle.key

Then PR your index/models/*.json into this repo, or host your own index and point clients at it with --index / $UNMUZZLE_INDEX. The full recipe, including torrent creation with web seeds, is in AGENTS.md. Format and threat model: SPEC.md.

Why not just Hugging Face / a mirror / a torrent site?

  • HF gates models behind human browser flows and can take them down (ERNIE ViLG, GEITje). In mainland China the site itself is blocked, which is why hf-mirror.com exists. Right default for ordinary models, wrong single point of failure for models someone wants suppressed, and unusable for agents hitting gated repos.
  • Mirrors (hf-mirror, ModelScope) reintroduce a single operator who can censor, and you cannot verify what they serve back to you.
  • A bare torrent has no discovery, no publisher identity, and dies at zero seeds. unmuzzle adds the index, per-file sha256, publisher signatures, and web seeds on top.

Roadmap

  • first real release (unmuzzle/qwen2.5-14b-abliterated)
  • MCP server for agent-native publish/download
  • standalone registry site generated from the index
  • DHT-native peer discovery, built-in torrent client (drop aria2c)
  • index federation: subscribe to multiple publisher indexes

License

MIT

Metadata

Release files for unmuzzle 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for unmuzzle 0.1.1
File Size Uploaded Provenance Actions
unmuzzle-0.1.1.tar.gz 19.3 kB Without provenance Details for unmuzzle-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for unmuzzle 0.1.1
File Interpreter ABI Platform Actions
unmuzzle-0.1.1-py3-none-any.whl Python 3 none any Details for unmuzzle-0.1.1-py3-none-any.whl

Total release size: 37.3 kB

Release files / unmuzzle-0.1.1.tar.gz

Download URL unmuzzle-0.1.1.tar.gz
Size 19.3 kB
Tags Source
SHA-256 checksum
How to use checksums
0f538d12d06252fe7413890b43b62e654a6b917e1ab45e32bad8eabd34dddd1a
BLAKE2b-256 checksum
How to use checksums
7386aae524cde258361f443544f0f2c47c4f9c40e79b98ea63c06da772530901
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release files / unmuzzle-0.1.1-py3-none-any.whl

Download URL unmuzzle-0.1.1-py3-none-any.whl
Size 18.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b8d2ab114daac849acde6fcb502ab522fe91a7ac9c2901945b3d5c1fb54f9083
BLAKE2b-256 checksum
How to use checksums
16e55b0d6661aca46a0cdbee06d05ae509ff98909f66ac858a0c2e5e4faf6eb7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Security for unmuzzle 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page