CLI

The CLI is installed with the Python SDK. See Authentication for environment configuration. Every API command uses the configured deployment’s /v1 routes. After logging in, use sutro quotas to verify that the deployment can reach Batch.

Command	Purpose
`sutro login`	Validate and save a deployment URL and API key.
`sutro set-api-url URL`	Change the saved deployment URL; changing deployments clears the saved key.
`sutro quotas`	Show row and token quotas by priority.
`sutro functions run NAME --input JSON`	Run a Function on one input and print the JSON response. `--input` takes a JSON object or `@path/to/input.json`.
`sutro jobs list`	Show the 25 most recent jobs.
`sutro jobs list --all`	Include all historical, cancelled, and failed jobs.
`sutro jobs status JOB_ID`	Show one job’s status.
`sutro jobs results JOB_ID`	Print results.
`sutro jobs attach JOB_ID`	Stream progress for a running job.
`sutro jobs attach --latest`	Attach to the most recent job.
`sutro jobs cancel JOB_ID`	Request cancellation.
`sutro cache show`	Show locally cached job results.
`sutro cache clear`	Clear the local results cache.
`sutro docs`	Open the documentation.

Result options

sutro jobs results JOB_ID \
  --include-inputs \
  --include-cumulative-logprobs \
  --save \
  --save-format parquet

--save-format accepts parquet or csv and defaults to parquet. Without --save, results print to the terminal. sutro set-base-url remains as a hidden deprecated alias for sutro set-api-url.