CLI reference / agent

stado agent

Invocation

stado agent [OPTIONS]

Purpose

Run local worker agent using live CPU, RAM, disk, and accelerator state

Required inputs and options

Input or optionContract
--gpu-type <GPU_TYPE>GPU type (auto-detected if --target/--auto absent) [default: ""]
--target <TARGET>Pull the target's accelerator and policy from the registry by name
--autoLook up self in registry by hostname; no manual config
--idle-shutdownExit (and self-delete the GCE VM) when no jobs are active and no queued job is eligible. Use on ephemeral cloud VMs
--kind <KIND>Consumer label in capacity broadcasts: "local" (physical box, default), "gcp" / "azure" / "aws" / "vast" (ephemeral cloud-agent VM) [default: local]
--vast-auto-listWhen the wisent-compute queue is empty, list this box on Vast.ai. Requires stado-vast/api_key in Skarbiec and WC_VAST_MACHINE_ID unless the machine can be discovered automatically
--vast-price-gpu <VAST_PRICE_GPU>Per-GPU-hour rental price USD when --vast-auto-list lists the box (default 0.50) [default: 0.5]
--vast-max-duration-s <VAST_MAX_DURATION_S>Cap the max rental length any Vast renter can buy from this offer (default 3600s = 1h). 0 to leave open-ended [default: 3600]

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • Requires stado-vast/api_key in Skarbiec and WC_VAST_MACHINE_ID unless the machine can be discovered automatically
  • 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.