MatrixHub开源模型中心

Docker Compose Deployment

Download the Docker Compose files for a released version and start MatrixHub:

export MATRIXHUB_VERSION=v0.1.1

mkdir -p matrixhub && cd matrixhub

curl -fL \
  "https://raw.githubusercontent.com/matrixhub-ai/matrixhub/$MATRIXHUB_VERSION/deploy/docker-compose.yml" \
  -o docker-compose.yml
curl -fL \
  "https://raw.githubusercontent.com/matrixhub-ai/matrixhub/$MATRIXHUB_VERSION/deploy/config.yaml" \
  -o config.yaml

MATRIXHUB_IMAGE_TAG="$MATRIXHUB_VERSION" docker compose up -d

For a newer stable release, replace v0.1.1 with the version you want to run. If port 3001 is already in use, set MATRIXHUB_HTTP_PORT before starting the stack, for example MATRIXHUB_HTTP_PORT=3002.

Open the MatrixHub web console:

http://127.0.0.1:3001

Sign in with the default local credentials:

Change the default password before exposing the instance outside your local machine.

To stop the local stack:

docker compose down

Helm (Kubernetes) Deployment

Prerequisites

Currently, the Helm chart supports PVC-backed storage for MatrixHub data. S3-compatible object storage is planned for a future release.

Make sure your cluster has a default StorageClass (kubectl get storageclass), or explicit storage settings for the PVCs this chart creates. For development clusters without a StorageClass, see development-only local storage setup.

Installing the Chart

MatrixHub publishes its Helm chart to GitHub Container Registry (ghcr.io) as an OCI artifact.

For a newer stable release, replace 0.1.1 with the chart version you want to run:

export CHART_VERSION=0.1.1
export NAMESPACE=matrixhub

Install the chart and expose the service via NodePort:

helm install matrixhub oci://ghcr.io/matrixhub-ai/matrixhub \
  --version "$CHART_VERSION" \
  --namespace "$NAMESPACE" --create-namespace \
  --set apiserver.service.type=NodePort

The default installation uses the cluster's default StorageClass. The MatrixHub data PVC defaults to 50Gi, and the built-in MySQL PVC defaults to 8Gi. To change PVC sizes, add --set apiserver.storage.pvc.size=100Gi or --set mysql.persistence.size=20Gi to the command.

For other storage classes, existing PVCs, and other Helm settings, see the Helm chart README.

Access the UI

With the NodePort installation above, open:

http://<node-ip>:30001

Find a node IP with:

kubectl get nodes -o wide

Uninstall

helm uninstall matrixhub --namespace "$NAMESPACE"

This removes resources including the default PVCs created by the chart. To preserve data, use an existing PVC for MatrixHub data and an external database.

🚀 Quick Start

🌐 Live Demo

Try MatrixHub instantly at demo.matrixhub.ai — no setup required.

Sign in with the public demo credentials:

The demo is for evaluation only and may be reset at any time.