divergent/docs
Compute · Commands

div model

Publish model weights on a volume as a version that div eval can measure, and list the model registry.

Synopsis

div model publish <model:tag> --volume <name> [--path <path>] [--run <run>] [flags]
div model ls [--project <name>] [flags]

Registers weights on a volume as a model version, and lists registered versions.

Subcommands

Subcommand Description
publish Register the weights at a path on a volume as <model:tag>. Creates the model on first use.
ls List every model version, newest first within each model.

Arguments

Argument Description
<model:tag> Model name and version tag, such as llama-ft:v3. This is the value div eval run --model takes.

Flags

Flag Description Default
--volume <name> publish: volume the weights are on. Required.
--path <path> publish: file or directory on the volume. the whole volume
--run <run> publish: run that produced the weights, by name or ID.
--project <name> publish: project the model belongs to. ls: only list this project. publish: the directory name. ls: all projects
--json Print as JSON.
--token <key> API key to use. see Configuration
--api-url <url> API URL to use. see Configuration

The version’s size is the total size of the files at the path, measured when you publish. Publishing a path with no files is rejected with the error code no_weights. Upload the weights first with div storage put. The volume and the run must belong to your org.

An eval run of the version receives the weights’ location as DIVERGENT_MODEL_PATH, for example /mnt/weights/llama-ft/v3.

Output

publish prints the version, its size and location. ls prints one row per version to stdout and a count to stderr:

redact:v0.4.0    23 MB  weights/redact/v0.4.0  2026-09-24
masker:v2       1.3 GB  weights/masker/v2      2026-09-21
masker:v1       1.3 GB  weights/masker/v1      2026-09-18
3 models, 3 versions

Exit codes

Code Meaning
0 Success.
1 The API rejected the request, for example no_weights.
2 Invalid flags or arguments, such as a missing --volume.

Examples

div storage put weights ./dist/redact redact/v0.4.0
div model publish redact:v0.4.0 --volume weights --path redact/v0.4.0
div model publish llama-ft:v3 --volume ckpt --path final --run run-k4t9
div model ls

See Compare model versions.

esc