# Divergent Labs docs

> Three products. Models: small task-specific models, called over HTTP and billed per token. Compute (private beta): GPU jobs billed per minute, started and followed with the div CLI. Sandboxes: Linux machines for agents that you create, stop and resume, from 3¢ an hour. Every page below is Markdown.

- [Divergent Labs](https://docs.divergentlabs.xyz/index.md): Documentation for Divergent Labs models, GPU compute and sandboxes.

## Models

- [Models](https://docs.divergentlabs.xyz/models.md): Small models that each do one job in a product, such as writing chat titles and inbox previews, called over HTTP and billed per token.
- [Rubric](https://docs.divergentlabs.xyz/models/rubric.md): API reference for Rubric, which writes chat titles and one-line previews of emails, messages, tickets and agent actions, at $0.10 per million input tokens.

## Compute (private beta)

- [Compute](https://docs.divergentlabs.xyz/compute.md): Run training and evaluation jobs on GPUs by the minute from the div CLI, with a spend limit in dollars.

### Guides

- [Use div in scripts and CI](https://docs.divergentlabs.xyz/compute/scripting.md): Run div unattended, branch on its exit codes, read its JSON output, and stop runs from a script.
- [Keep data and checkpoints on a volume](https://docs.divergentlabs.xyz/compute/guides/volumes.md): Upload a dataset once, read it from every run, save checkpoints that outlast the run, and download them.
- [Report a run's metrics and check them](https://docs.divergentlabs.xyz/compute/guides/results.md): Write a run's metrics to its result file, pass or fail the run's checks against them, and read them back from a script.
- [Chart training metrics](https://docs.divergentlabs.xyz/compute/guides/telemetry.md): Record loss, learning rate and other metrics during a run, lay out the run's charts, and export the values.
- [Compare model versions](https://docs.divergentlabs.xyz/compute/guides/evaluate.md): Publish model weights as versions, measure each version with the same evaluation, and rank them.
- [Pass credentials to a run](https://docs.divergentlabs.xyz/compute/guides/secrets.md): Store an API token as a secret so every run can read it from its environment without putting it on the command line.

### Commands

- [div login](https://docs.divergentlabs.xyz/compute/cli/login.md): Sign this machine in through the browser and save an API key.
- [div whoami](https://docs.divergentlabs.xyz/compute/cli/whoami.md): Show the org, plan, credit, API key and API URL this machine uses, and where the key came from.
- [div run](https://docs.divergentlabs.xyz/compute/cli/run.md): Start a run with the current directory's code and stream its log until it ends.
- [div logs](https://docs.divergentlabs.xyz/compute/cli/logs.md): Print a run's log, or follow it until the run ends.
- [div result](https://docs.divergentlabs.xyz/compute/cli/result.md): Print the JSON result a run wrote to DIVERGENT_RESULT_PATH, or one value from it.
- [div telemetry](https://docs.divergentlabs.xyz/compute/cli/telemetry.md): Print the metrics a run recorded in DIVERGENT_TELEMETRY_PATH, as a summary or as columns.
- [div eval](https://docs.divergentlabs.xyz/compute/cli/eval.md): Measure a model version with an evaluation, list evaluations, and print an evaluation's ranking.
- [div model](https://docs.divergentlabs.xyz/compute/cli/model.md): Publish model weights on a volume as a version that div eval can measure, and list the model registry.
- [div runs](https://docs.divergentlabs.xyz/compute/cli/runs.md): List the org's runs, newest first, with status, hardware, hourly rate and cost.
- [div stop](https://docs.divergentlabs.xyz/compute/cli/stop.md): Stop a run and print what it cost.
- [div storage](https://docs.divergentlabs.xyz/compute/cli/storage.md): List, upload and download files on a volume.
- [div secrets](https://docs.divergentlabs.xyz/compute/cli/secrets.md): Set, list and delete the secrets every run receives as environment variables.
- [div papers](https://docs.divergentlabs.xyz/compute/cli/papers.md): Search arXiv without an API key and print papers one per line, or in full by ID.
- [div catalog](https://docs.divergentlabs.xyz/compute/cli/catalog.md): List the GPU types that --gpu accepts, with GPU memory, included cores and memory, and hourly price.
- [div limits](https://docs.divergentlabs.xyz/compute/cli/limits.md): Show the org's sandboxes, seats, GPUs, containers and storage against its limits, and its spend against its usage limit.
- [div dashboard](https://docs.divergentlabs.xyz/compute/cli/dashboard.md): Open the dashboard in the browser, or print its link.
- [div upgrade](https://docs.divergentlabs.xyz/compute/cli/upgrade.md): Install div, upgrade it to the latest release, or switch to a specific version.

### Reference

- [Runtime environment](https://docs.divergentlabs.xyz/compute/runtime.md): The image, hardware, filesystem, environment variables and time limit every run starts with.
- [Configuration](https://docs.divergentlabs.xyz/compute/cli/configuration.md): Where div reads its API key, API URL and project from, and in what order.
- [Exit codes and errors](https://docs.divergentlabs.xyz/compute/cli/exit-codes.md): The exit codes div returns, where it writes output, and the API error codes it reports with the fix for each.
- [MCP server](https://docs.divergentlabs.xyz/compute/mcp.md): Setup, environment variables and tools of the Divergent MCP server, which exposes the div operations to an MCP client.

## Sandboxes

- [Sandboxes](https://docs.divergentlabs.xyz/sandboxes.md): Linux machines that you or your agent create in seconds, run commands in, stop, and resume later, from 5¢ an hour.

### Guides

- [Stop, resume and fork a sandbox](https://docs.divergentlabs.xyz/sandboxes/snapshots.md): How to stop a sandbox to pay only for storage, resume it later, stop it automatically when idle, and fork it into copies.
- [Use the desktop and browser](https://docs.divergentlabs.xyz/sandboxes/desktop.md): How to start a sandbox's desktop, drive its Chromium browser from an agent, and watch or take control from the dashboard.
- [Reach your machine from a sandbox](https://docs.divergentlabs.xyz/sandboxes/tunnels.md): How to make a port on your machine available inside a sandbox, and how to send a sandbox's internet traffic out through your machine.
- [Use a sandbox over SSH](https://docs.divergentlabs.xyz/sandboxes/ssh.md): How to open a shell on a sandbox, copy files with scp or rsync, connect an editor, and use sandboxes with only ssh installed.
- [Run a coding agent in a sandbox](https://docs.divergentlabs.xyz/sandboxes/agents.md): How to give a sandbox's coding agent your credentials, send it a task, follow and continue its conversations, run several at once, and stop the sandbox when they finish.

### Commands

- [div sandbox](https://docs.divergentlabs.xyz/sandboxes/cli/sandbox.md): Reference for div sandbox, the command that creates, runs commands in, stops, resumes, forks and deletes sandboxes.
- [div agent](https://docs.divergentlabs.xyz/sandboxes/cli/agent.md): Reference for div agent, the command that sends tasks to the coding agents in a sandbox and prints their conversations.
- [ssh div.io](https://docs.divergentlabs.xyz/sandboxes/cli/ssh-prompt.md): Reference for the commands at the ssh div.io prompt, which manage sandboxes, keys, orgs, plans and credit with only ssh.

### Reference

- [Sandbox MCP tools](https://docs.divergentlabs.xyz/sandboxes/mcp.md): Reference for the sandbox tools in the Divergent MCP server, with each tool's parameters and response.
- [Sandbox pricing and plans](https://docs.divergentlabs.xyz/sandboxes/pricing.md): Reference for what a sandbox costs by size, what stopped storage costs, and what each plan includes and allows.