CLI reference / inference / plan

stado inference plan

Invocation

stado inference plan [OPTIONS] --host <HOST> --image <IMAGE> --model <MODEL> --revision <REVISION> <NAME>

Purpose

Inspect the target and persist an immutable, registry-bound plan

Required inputs and options

Input or optionContract
<NAME>Positional input; required or optional as shown in the invocation.
--host <HOST>Command option; required or optional as shown in the invocation.
--image <IMAGE>Digest-pinned vLLM image (`repository@sha256:digest`)
--model <MODEL>Command option; required or optional as shown in the invocation.
--revision <REVISION>Immutable Hugging Face commit SHA
--gpu-mode <GPU_MODE>`exclusive` keeps the GPU reserved; `yieldable` pauses inference whenever an eligible GPU job is queued and resumes it afterward [default: exclusive] [possible values: exclusive, yieldable]
--port <PORT>[default: 8001]
--max-model-len <MAX_MODEL_LEN>[default: 32768]
--kv-cache-memory-gb <KV_CACHE_MEMORY_GB>Fixed vLLM KV-cache allocation in GiB; omit to use the image policy
--cache-dir <CACHE_DIR>Persistent host directory for the Hugging Face model cache
--jsonCommand option; required or optional as shown in the invocation.

Output and state effect

This is an inspection/reporting operation. It emits the result described above and does not change managed state unless an explicit option in this page says otherwise. Pass `--json` when the command exposes that machine-readable option.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.