CLI - Servo

Authenticate with servo login. Use servo COMMAND --help for all flags. See the quickstart for a complete example.

Models and deployments

Command	Purpose
`servo model inspect hf://ORG/REPO --revision REV`	Show input keys, shapes, dtypes and output shape without allocating a GPU
`servo model import hf://ORG/REPO --revision REV`	Prepare a checkpoint using your connected Hugging Face account
`servo model list`	List models
`servo model deploy MODEL_ID --city CITY --wait`	Deploy and wait for readiness
`servo deployment list`	List deployments; `--links` includes dashboards
`servo deployment show ID`	Inspect status and failures
`servo deployment wait ID`	Wait for readiness
`servo deployment logs ID`	Open links to logs and telemetry
`servo deployment stop ID`	Request shutdown; use `show` to confirm retirement

Deploy accepts one of --city, --region, --latlon or --robot. Use --deployment-key for a separate deployment at the same site. --idle-minutes opts into idle release; otherwise capacity stays warm until stopped. Predict through the Python SDK.

Identity and robots

Command	Purpose
`servo login`	Browser or device-code sign-in
`servo whoami`	Show current identity and organization
`servo logout`	Sign out; `--everywhere` ends all sign-ins
`servo agent install --name NAME`	Enroll this robot computer and run its agent
`servo robot approve [CODE]`	Approve enrollment; without a code, opens the page to enter it
`servo robot list`	List robots
`servo robot show NAME`	Inspect robot and sessions
`servo robot remove NAME`	Revoke installations and retire the robot
`servo doctor`	Diagnose session connectivity

Access and recordings

Command	Purpose
`servo access grant SUBJECT --robot NAME --role ROLE`	Grant `read`, `write` or `admin`
`servo access list --robot NAME`	List grants
`servo access revoke SUBJECT --robot NAME`	Remove a grant
`servo session list`	List recorded sessions; filter with `--robot NAME`
`servo session show ID`	Inspect a recorded session
`servo episode list`	List local recordings
`servo episode show PATH`	Summarize a recording; `--last` picks the newest
`servo episode rm PATH`	Delete a recording after confirmation

See identity and access for required roles.