Skip to main content
A machine starts from an image: the operating system and the tools on it. Images come in families, and each version has a name like creative@17.

Name an image

image on POST /v1/machines (and --image on voyager cloud lease) takes: The machine’s image is the registry name it runs, and image_pin is the name that keeps it (creative@17). An unknown name is refused with 400 invalid_request.

List images and versions

GET /v1/machines/images lists each family’s current version. Add ?all=true for every version; older ones are marked hidden: true and you can still lease them. Each image has pin, family, version, released (YYYY-MM-DD) and changes (what changed from the version before).

When the default moves

Voyager announces a default move before it happens. While one is announced, the family’s images in GET /v1/machines/images carry next_default ({name, on}), and every machine on the current default carries image_notice, which names the pin that keeps it. Lease with that pin to stay on your version.

Pin a project

  • voyager cloud images lists each family’s current version, with what changed; --all adds older ones.
  • voyager cloud images pin [name] saves a version (default: the current creative) in voyager-cloud.lock.json in your project. lease and run then use it unless --image names another. Commit the file with your project.
  • voyager cloud lease prints the default-move notice when there is one.

Changelog

Generated from Voyager’s image registry.

Creative (creative)

Blender LTS and latest, Vork, Vauss, ffmpeg with NVENC, PyTorch, the Voyager assets core library and the Voyager cloud CLI: the default image. Current version: creative@18.

ComfyUI (comfyui)

ComfyUI with a curated node set and permissively licensed models on local disk (FLUX.1 [schnell], Wan 2.2 TI2V 5B); it also reads models from a volume at /persist/comfyui/models, the workspace’s model cache. Current version: comfyui@1. What it bakes in, with each licence:

ML training (ml)

PyTorch 2.8 (CUDA 12.8) with Transformers, Accelerate, PEFT, Datasets, Lightning, xformers and JupyterLab, for training and fine-tuning; checkpoints belong on a volume. Current version: ml@1.

Base (base)

Python, ffmpeg and the NVIDIA libraries only, for smoke tests. Current version: base@1.