CLI

Commands for models, deployments and access.

Use servo COMMAND --help for all flags; the quickstart has a complete example.

deployment show uses existing telemetry links; deployment logs sets up missing workspaces.

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	Import and compile via your connected Hugging Face account (--no-wait, --timeout); repeated imports return the existing model, regardless of --slug
servo model list	List models
servo model delete MODEL	Delete one of your models by ID or slug; stop its deployments first
servo model deploy hf://ORG/REPO	Import and deploy, then wait for readiness (--no-wait)
servo deployment list	List live deployments; --all includes ended ones, --links adds dashboards
servo deployment show ID	Inspect status, what it waits on, failures, logs and telemetry links
servo deployment wait ID	Print readiness progress: capacity, preparation, runtime, network, loading and endpoint checks
servo deployment logs ID	Print links to logs and telemetry; --tail N prints recent log lines
servo deployment stop ID	Stop; --wait waits until capacity is released; or --model PATH, or --all

Deploy places the endpoint automatically. Pass one of --city, --region, --latlon or --robot to choose a place. Use --name for a separate deployment at the same site. Idle deployments stop after 240 minutes (--idle-minutes shortens). Limit: 4 active deployments.

Identity and robots

Command	Purpose
servo login	Sign in; prints a link to open on any device (--browser)
servo whoami	Show current identity and organization
servo logout	Sign out
servo agent install --name NAME	Enroll this robot computer; --run keeps its agent running
servo robot approve [CODE]	Approve enrollment (admin); 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 (admin)
servo doctor	Check session connectivity (--verbose)

Access

Command	Purpose
servo access grant ROBOT SUBJECT --role ROLE	Grant read or write (admin)
servo access list ROBOT	List grants (admin)
servo access revoke ROBOT SUBJECT	Remove a grant (admin)

See identity and access for required roles.