Skip to main content

​
list

List checkpoints for a Loops run, newest first. Identify the run with —run-id, or pass —base-model to list checkpoints across all of your runs of that base model.

​
Options

​
TEXT
List checkpoints across your runs of this base model.Mutually exclusive with other flags in group loops-checkpoint-scope.
​
TEXT
default:"desc"
Sort order by creation time: ‘desc’ (newest first) or ‘asc’ (oldest first).One of: asc, desc
​
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
​
TEXT
default:"text"
Output formatOne of: text, json, jsonl, none
​
TEXT
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
​
TEXT
List checkpoints saved by this run.Mutually exclusive with other flags in group loops-checkpoint-scope.
​
BOOL
Enable verbose logging

​
Examples

List a run’s checkpoints
List every checkpoint for a base model, oldest first

​
Filter output with --jq

Print the deployable checkpoint names

​
Output

Text mode (--output text): Table with columns: ID, NAME, RUN, TARGET, TYPE, SIZE, CREATED. When no checkpoints match, prints “No Loops checkpoints found.” to stderr. JSON mode (--output json): payload type managementapi.ListLoopsCheckpointsResponse.

​
files

List presigned download URLs for the files under a Loops checkpoint. The URLs are short-lived. Use ‘baseten loops checkpoint list’ to find checkpoint IDs. For machine-readable streaming, prefer —output jsonl over —output json.

​
Options

​
TEXT
required
ID of the Loops checkpoint.
​
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
​
TEXT
default:"text"
Output formatOne of: text, json, jsonl, none
​
TEXT
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
​
BOOL
Enable verbose logging

​
Examples

List a checkpoint’s files

​
Filter output with --jq

Print just the download URLs

​
Output

Text mode (--output text): Table with columns: NAME, SIZE, URL. JSON mode (--output json): payload type managementapi.CheckpointFile.

​
deploy

Deploy checkpoints saved by a Loops run as a model served by vLLM. Name the checkpoints with —checkpoint (which needs —run-id, since names are scoped to a run) or with —checkpoint-id, or pass none of them to choose interactively. Requests then select a checkpoint by name through the model parameter, so one deployment serves them all. Pass —config for a repeatable deploy: it is a Python file defining a DeployCheckpointsConfig, so it is executed rather than read.

​
Options

​
TEXT (repeatable)
Name of a checkpoint to deploy, for example ‘step-50’. Requires —run-id, since names are scoped to a run. Cannot be combined with —checkpoint-id or —config. Repeatable.
​
TEXT (repeatable)
ID of a checkpoint to deploy. Cannot be combined with —run-id, —checkpoint, or —config. Repeatable.
​
TEXT
Python file defining a DeployCheckpointsConfig: which checkpoints deploy and the model that serves them. Cannot be combined with —checkpoint or —checkpoint-id.
​
BOOL
Print the generated model config without deploying anything.
​
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
​
TEXT
default:"text"
Output formatOne of: text, json, jsonl, none
​
TEXT
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
​
TEXT
Loops run whose checkpoints are deployed. Cannot be combined with —checkpoint-id.
​
TEXT
Run this truss executable instead of fetching one with uv, e.g. a virtualenv’s bin/truss. A value with no path separator is looked up on PATH, so ‘—truss-executable truss’ runs the truss you installed. Defaults to BASETEN_TRUSS_EXECUTABLE.
​
BOOL
Do not forward this CLI’s credentials to truss, leaving it to resolve a remote from your trussrc. Old truss versions ignore forwarded credentials and use the trussrc regardless.
​
TEXT
Version of truss to fetch and run with ‘uv tool run’, e.g. 0.18.26. Defaults to BASETEN_TRUSS_VERSION, or the latest release. Mutually exclusive with —truss-executable.
​
BOOL
Enable verbose logging

​
Examples

Deploy two checkpoints of a run by name
Deploy a checkpoint by ID, choosing the rest interactively

​
Output

Text mode (--output text): The new model and deployment IDs with links to the deployment’s logs, and how to name a checkpoint in a request. With —dry-run, the generated model config instead. JSON mode (--output json): payload type cmd.TrussDelegatedResult. Under —output json the text output goes to stderr and stdout is an empty object: this command reports nothing structured yet.