> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baseten.co/llms.txt
> Use this file to discover all available pages before exploring further.

# baseten loops

> Manage Loops runs and checkpoints

## usage

```sh theme={"system"}
baseten loops usage [OPTIONS]
```

Report Loops GPU capacity, one row per trainer deployment plus a row for each standalone sampler.

A summary above the table totals the GPUs in use and scaled to zero. Rows holding no live GPUs (scaled to zero, or in a terminal state) are counted in the summary but hidden unless you pass --all.

### Options

<ParamField body="--all" type="BOOL">
  Include allocations holding no live GPUs (scaled to zero, or in a terminal state).
</ParamField>

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="--org" type="BOOL">
  Report usage across the organization, with each allocation's owner, instead of only your own.
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--user" type="TEXT">
  Only report allocations owned by this email. Implies --org.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Report your own Loops GPU usage

```sh theme={"system"}
baseten loops usage
```

Report GPU usage across the organization, including idle allocations

```sh theme={"system"}
baseten loops usage --org --all
```

Report GPU usage for one owner

```sh theme={"system"}
baseten loops usage --org --user someone@example.com
```

### Filter output with `--jq`

Print the total trainer GPUs in use

```sh theme={"system"}
baseten loops usage --jq '.summary.trainer_in_use'
```

### Output

**Text mode (`--output text`):** A summary line of trainer and sampler GPU totals, then a table with columns: RUN, OWNER (with --org), BASE MODEL, TRAINER GPU, TRAINER STATUS, SAMPLER GPU, SAMPLER STATUS, CREATED.

**JSON mode (`--output json`):** payload type `cmd.LoopsUsageResult`.

An object with the GPU summary and one entry per row, each carrying the trainer and sampler allocation and status.