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.

Formerly the Container Registry

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, the same backing storage, and the same endpoint.

---

Endpoints

Purpose	URL
OCI registry (Docker, ORAS, hippius-hub)	registry.hippius.com
Web UI (browse models & containers)	hub.hippius.com
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 repositories: only you and the keys you issue can pull them.

---

Five-minute path

Pick the flow that matches what you're shipping. The CLI install and namespace provisioning are the same either way.

A $10 balance before the first namespace

The Free plan can create a namespace only when the account holds a balance of at least $10 (a spam check). A zero balance is refused. Top up on Billing before hippius-hub registry provision. The plan itself stays free.

Models (Python)

# 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 — your existing transformers / diffusers code keeps working:

import hippius_hub as huggingface_hub
from transformers import AutoModel

model = AutoModel.from_pretrained("my-models/qwen-7b")

Containers (Docker)

# 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

Same Python API as Hugging Face

The Model Registry is a drop-in for huggingface_hub. Same cache layout, same function signatures, same exception classes — so transformers.from_pretrained(...) and any other code that uses huggingface_hub under the hood works without modification. See Pull for the full Python surface.

---

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-hub command surface, grouped by goal.