veri is the official command-line tool. It ships with the Python SDK; one install gets you both.
By the end of this page you’ll have the CLI installed, an authenticated session, and a map of every command group.
Install
Log in
Pick the flow that fits your environment.veri whoami shows the account it resolves to (user and email) alongside the active key, config file path, and credit balance. veri doctor runs a health check against the control plane.
Credentials live at
~/.config/veri/config.toml on Linux (or $XDG_CONFIG_HOME/veri/config.toml) and ~/Library/Application Support/veri/config.toml on macOS — veri whoami prints the active path. The CLI auto-migrates from the legacy ~/.veri/credentials.json path when neither VERI_API_KEY nor VERI_API_URL is set in the environment. Env vars take precedence over the file.Command groups
Plus top-level:
veri login, veri logout, veri whoami, veri doctor, veri version, veri init.
Global flags
These flags are spliced into every command group by Veri’s Typer wrapper:Exit codes
Where to go next
veri run
The hero verb — submit any workflow from a TOML config.
Datasets
Upload, connect, validate.
Training
Training jobs and reward files.
Deployments
Serve, chat, stop.
Volumes
Managed storage for datasets and checkpoints.
Reference
Full command table, all flags, all exit codes.