Skip to main content
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

The mcp extra adds veri mcp serve for MCP clients such as Claude Code and Cursor. To upgrade an existing install, or add the extra to one, run uv tool install --upgrade 'veri-sdk[mcp]' (pipx: the line above; pip: pip install -U 'veri-sdk[mcp]'). uv tool upgrade and pipx upgrade never add an extra. Verify:

​
Log in

Pick the flow that fits your environment.
On a machine without a browser (an SSH session), veri login --no-browser skips opening one and goes straight to the paste prompt. --timeout sets how many seconds the browser flow waits for you to authorize (default 300) before it falls back to pasting. Confirm:
veri whoami shows the account it resolves to (user and email), the active workspace (name, id, personal or team), the active key, config file path, and that workspace’s 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 the legacy ~/.veri/credentials.json file the first time it runs without a config file, unless VERI_CONFIG_PATH or XDG_CONFIG_HOME is set. Env vars take precedence over the file.

​
Command groups

Plus top-level: veri login, veri logout, veri whoami, veri doctor, veri version, veri init, veri deploy (deploy a Hugging Face model or a finished training job in one step, see Deployments), veri run-script (a custom training script) and veri run-harness (RL-train the model inside your agent harness).

​
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

Persistent named storage for your files.

Reference

Full command table, all flags, all exit codes.