v0.8.1

Native install (Apple Silicon / homelab)

uv tool install mship
mship bootstrap --metal
mship start --config models.yaml

Docker images

Thin (control/coordinator — default, no torch/vllm)

docker pull ghcr.io/modelship-ai/modelship:0.8.1

CUDA (GPU node)

docker pull ghcr.io/modelship-ai/modelship:0.8.1-cuda

CPU (CPU node)

docker pull ghcr.io/modelship-ai/modelship:0.8.1-cpu

Floating tags (:latest, :latest-cuda, :latest-cpu) are single-node only — for any
multi-node cluster, pin every node to the same X.Y.Z tag to avoid a Ray version
mismatch between head and workers.

Helm chart (Kubernetes)

helm install modelship \
  oci://ghcr.io/modelship-ai/charts/modelship \
  --version 0.8.1 \
  -f values.yaml

Running an image

The images take the same subcommands as the mship CLI:

docker run --rm --shm-size=8g \
  -v ./models.yaml:/models.yaml \
  -v ./models-cache:/.cache \
  -p 8000:8000 \
  ghcr.io/modelship-ai/modelship:0.8.1-cpu start --config /models.yaml

Configuration

Create a models.yaml file, mount it and pass it with --config. Example configs for various GPU sizes are included in the image under /modelship/config/examples/ — use them as a reference for structure and available options, then tailor the models and GPU fractions to your hardware.

What's Changed

• Fix/quiet stop by @alez007 in #249
• Fix/ray idle threads by @alez007 in #250

Full Changelog: v0.8.0...v0.8.1