divergent/docs
ComputePrivate beta

Compute

Run training and evaluation jobs on GPUs by the minute from the div CLI, with a spend limit in dollars.

Compute is in private beta. It is open to invited orgs, and its commands, flags and prices can change before general availability. Request access.

What it is

Compute runs a job on one or more GPUs until the job exits. You start it from your code’s directory with div run. div uploads the directory, starts the run, streams its log, and exits with the run’s exit code.

A run ends when its command exits, when you stop it, when it reaches its --max-spend limit, or after 24 hours. For a Linux machine that you keep and reuse, use a sandbox instead.

What it costs

Runs are billed per minute, with a one-minute minimum, from the org’s credit.

GPU Per hour, per GPU
b300 $8.95
h200 $5.95
h100 $4.95
cpu (no GPU) $0.30

Each GPU includes 1 CPU core and 8 GiB of memory. Extra cores cost $0.17 an hour each and extra memory $0.03 per GiB an hour. div catalog prints the current prices.

Quickstart

  1. Install div:

    curl -fsSL https://div.io/install.sh | sh

  2. Sign in. The command opens the dashboard in your browser. Approve the request if the code on the page matches the code in the terminal.

    div login

  3. From your code’s directory, start a run on one H100 with a $5 spend limit:

    cd ~/very-cool-classifier
div run --gpu h100 train.py::run --max-spend 5.00

    The output looks like this:

    Created project very-cool-classifier.
14 files, 38.2 KB → very-cool-classifier-code/code/9f31c2ab
run-k4t9  H100  $4.95/h  max spend $5.00 (about 1h 0m)
...your program's output...
run-k4t9 finished in 12m 40s and spent $1.05

    The third line shows the hourly rate and how long the spend limit lasts at that rate. div writes its own lines to stderr and your program’s output to stdout.

  4. Check what is running and stop it:

    div runs --status active
div stop run-k4t9

Next steps

Commands

Command Description
div login Sign this machine in and save an API key.
div whoami Show the org, API key and API URL in use.
div run Start a run and stream its log.
div logs Print or follow a run’s log.
div result Print a run’s result JSON, or one value from it.
div telemetry Print the metrics a run recorded.
div eval Measure a model version and rank it.
div model Publish and list model versions.
div runs List the org’s runs.
div stop Stop a run.
div storage List, upload and download files on a volume.
div secrets Set, list and delete secrets.
div papers Search and read arXiv papers.
div catalog List GPU types and prices.
div limits Show usage against the plan’s limits.
div dashboard Open the dashboard.
div upgrade Install, upgrade or pin a div version.
esc