Hippius Hub
The AI model registry built for distributed compute. Hippius Hub is a registry for AI models and OCI artifacts. Pull public repositories anonymously, and push with an account.
In the console this product is now called Hub. The endpoint (registry.hippius.com) and the hippius-hub registry … CLI commands keep their names, so nothing in your scripts needs to change.
It has two faces:
| Face | What it is | Who uses it |
|---|---|---|
| Model Registry | A drop-in replacement for Hugging Face Hub. Same Python API (hf_hub_download, snapshot_download, from_pretrained), backed by an OCI registry instead of huggingface.co. | ML engineers loading models with transformers, diffusers, or any library that uses huggingface_hub under the hood. |
| Container Registry | A standard OCI registry. Push and pull Docker images, ORAS artifacts, and raw OCI blobs against registry.hippius.com. | Anyone running docker push / docker pull, plus power users with oras for non-image artifacts. |
Both faces share the same authentication and the same endpoint (registry.hippius.com).
Endpoints
| Purpose | URL |
|---|---|
OCI registry (Docker, ORAS, hippius-hub) | registry.hippius.com |
| Web UI | hub.hippius.com: public model and container browse, per-repo pull commands, a Docs page, and /llms.txt |
| Source / issues | github.com/thenervelab/hippius-hub |
Models are indexed server-side by format, architecture, parameter count, and quantization, so search on hub.hippius.com works the way you'd expect.
Private namespaces: only you and the keys you issue can pull from them. Publicity is per namespace, not per repository.
Five-minute path
Pick the flow that matches what you're shipping. The CLI install and namespace provisioning are the same either way.
The Free plan can create a namespace only when the account holds a balance of at least $10. A zero balance is refused. Top up on Billing before hippius-hub registry provision. The plan itself stays free.
- Models (Python)
- Containers (Docker)
# 1. Install the unified CLI (also the Python library)
pip install hippius_hub
# 2. Save your API token from https://console.hippius.com/dashboard/settings
hippius-hub login --hippius-token <paste-token-here>
# 3. Provision a namespace + run docker login in one shot
hippius-hub registry provision my-models --docker-login
# 4. Push a model folder as :v1
hippius-hub upload my-models/qwen-7b ./qwen-7b --revision v1
Pulling from Python is a one-line import swap in your code:
from hippius_hub import snapshot_download, hf_hub_download
from transformers import AutoModel
snapshot_download(repo_id="my-models/qwen-7b", revision="v1")
model = AutoModel.from_pretrained(
"my-models/qwen-7b",
cache_dir="~/.cache/hippius/hub",
)
import hippius_hub as huggingface_hub only aliases the name in that file. transformers still imports the real huggingface_hub package, so point from_pretrained at the Hippius cache (or at a local folder from snapshot_download) after you have downloaded.
# 1. Install the CLI for namespace provisioning + credential helpers
pip install hippius_hub
# 2. Save your API token from https://console.hippius.com/dashboard/settings
hippius-hub login --hippius-token <paste-token-here>
# 3. Provision a namespace and run docker login in one shot
hippius-hub registry provision my-models --docker-login
# 4. Tag and push an image
docker tag my-app:latest registry.hippius.com/my-models/my-app:v1
docker push registry.hippius.com/my-models/my-app:v1
Pulling a public image needs no login:
docker pull registry.hippius.com/my-models/my-app:v1
The Model Registry is a drop-in for huggingface_hub: same cache layout, same function signatures, same exception classes. Replace from huggingface_hub import ... with from hippius_hub import .... See Pull for the full Python surface and how from_pretrained finds the files.
Hub in the Console
Everything the CLI does to your namespace, you can also see and do in console.hippius.com, under Hub in the sidebar:
- Set up a namespace without the CLI.
- Browse every container and model you have pushed, with artifact and pull counts, and delete what you no longer need.
- Manage your namespace: switch between public and private, and rotate docker credentials for CI/CD.
- Pick a plan and pay for it from your account balance.
The full walkthrough is on the Hub console page. Pricing is also listed at hippius.com/hippius-hub.
Where to next
- Pull: download a single file or a whole repo from Python, the CLI, or
docker pull. - Push: provision a namespace, push artifacts, manage credentials.
- CLI reference: the
hippius-hubcommand surface, grouped by goal.