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, email, plan) 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 (or $XDG_CONFIG_HOME/veri/config.toml). 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
Reward functions and training jobs.
Deployments
Serve, chat, stop.
Evaluations
Score deployments, inspect runs.
Volumes
Managed storage for datasets and checkpoints.
Reference
Full command table, all flags, all exit codes.