The `hippius-hub` CLI

hippius-hub is the unified CLI for namespace provisioning, credential management, registry search, and parallel uploads / downloads. It's the same package that ships the Python library: install it once and use either surface.

Full reference and source: github.com/thenervelab/hippius-hub. For AI agents and coding assistants there's a self-contained reference at llms.txt.

Install

pip install hippius_hub

hippius-hub --version
hippius-hub --help

Published wheels include the pre-built Rust core, so no toolchain is needed. Building from source requires Rust via rustup. See the README for the source path.

PyPI is currently 0.7.0. The git main branch can be ahead (0.7.2 as of 2026-09-07). pip install hippius_hub gets the wheel. The CLI prints a notice when a newer wheel exists; set HIPPIUS_HUB_NO_UPDATE_CHECK=1 to turn it off (also auto-off when CI=true).

Two kinds of credentials

For…	Use	Cached at
`registry` and `models` commands	API token from console.hippius.com/dashboard/settings	`~/.cache/hippius/hub/api_token`
`upload` / `download` (raw OCI registry IO)	Docker registry credentials	`~/.cache/hippius/hub/token`

In practice the API token is all you save by hand. hippius-hub registry provision <namespace> mints the docker credentials and writes them into the second cache for you. Pass --docker-login to also run docker login so docker push / docker pull work.

hippius-hub login --hippius-token <token>
hippius-hub login --username <you> --password <secret>   # docker creds, manual path

Manage your namespace

Command	Purpose
`registry plans`	List pricing tiers and quotas
`registry check <name>`	Is a namespace available?
`registry provision <ns> [--docker-login]`	Create your namespace; new projects are public by default. The Free plan requires a balance of at least $10 on the account first
`registry status`	Poll an in-flight provision until the robot secret is ready
`registry me`	Plan, quota, status, and robot login of your active project
`registry repos [--page N --page-size M]`	List your repositories (page size default 50)
`registry repos delete <project>/<repo> [--missing-ok] [-y]`	Delete a whole repository from the CLI
`registry artifacts <repo>`	List artifacts in one repo (page size default 50)
`registry usage`	Storage used + 7-day history
`registry publicity public\|private`	Toggle anonymous-pull access (also resizes quota to the plan's tier)
`registry rotate-token [--docker-login]`	Issue a new docker secret (old one stops working immediately)
`registry keys list`	List scoped keys for the active project
`registry keys create <name> --role read\|push\|push-delete\|admin [--expires-days N] [--docker-login]`	Issue a scoped key; secret printed once
`registry keys show\|rotate\|revoke <key-id>`	Inspect, rotate the secret, or delete a key
`revisions <repo> [--json]`	List a repository's revisions, newest first

Upload & download

hippius-hub upload my-models/qwen-7b ./qwen-7b --revision v1
hippius-hub download my-models/qwen-7b model.safetensors --verify-hash
hippius-hub diagnose my-models/qwen-7b model.safetensors --verbose --json

--verify-hash forces the whole-file check when HIPPIUS_VERIFY_HASH=0. The check is on by default.

Full workflows with merge semantics, single-file uploads, and HF-mirroring: Push. Parallel-download tuning: Pull.

Search the model index

Every artifact is parsed server-side (GGUF, safetensors, ONNX, Diffusers) and indexed by format / architecture / parameter count / quantization.

hippius-hub models list --format gguf --arch llama --quant int4 --min-params 1000000000 --max-params 8000000000 -q "qwen"
hippius-hub models list --page 1 --page-size 25
hippius-hub models show my-models/qwen-7b              # all versions of a repo
hippius-hub models show my-models/qwen-7b v1           # one version, with file breakdown
hippius-hub models list --mine                         # restrict to your own
hippius-hub models formats                             # available filter values

Add --json to models list / models show for machine-readable output.

Subscriptions

hippius-hub registry subscribe Builder                 # name or numeric plan_id
hippius-hub registry subscribe Builder --pay-upfront 6 # pay 1–24 months at once
hippius-hub registry subscriptions                     # list current subscriptions
hippius-hub registry unsubscribe <sub-id>              # cancel; 30-day grace before hard delete

The CLI resolves the plan name to an id, then POSTs {"plan_id": <int>} to /api/registry/subscribe/. After unsubscribe, docker login stops working on the next sync (about 3 minutes). Artifacts and the project stay until the 30-day grace ends.

Hub has no one-step plan swap. If you subscribe while a paid plan is still active, you can be billed for both. Cancel first, then subscribe to the new plan.

Pricing details: hippius.com/hippius-hub.

Environment variables

Env var	Default	Purpose
`HIPPIUS_CHUNK_SIZE`	`104857600` (100 MiB)	Per-chunk size for the parallel Rust downloader
`HIPPIUS_VERIFY_HASH`	on	Set to `0`/`false` to skip the whole-file SHA256 check on plain downloads. Chunked downloads always verify
`HIPPIUS_API_URL`	`https://api.hippius.com`	Console API base used by the `registry` and `models` commands
`HIPPIUS_MAX_CONCURRENT`	16	Parallel Range connections per file
`HIPPIUS_SNAPSHOT_WORKERS`	8	File-parallelism for `snapshot_download`
`HIPPIUS_UPLOAD_WORKERS`	8	Upload worker count
`HIPPIUS_HUB_NO_UPDATE_CHECK`	off	Set to `1` to silence the newer-version notice (`CI=true` also silences it)

Where to next

Quickstart: the five-minute path from zero to push or pull.
Pull: download a file, a whole repo, or pull by digest.
Push: provision a namespace and ship your first artifact.

The hippius-hub CLI

Install​

Two kinds of credentials​

Manage your namespace​

Upload & download​

Search the model index​

Subscriptions​

Environment variables​

Where to next​