Reflex Docs
CLI

reflex training

Start, watch, list, and stop fine-tuning runs.

Training runs operate on a validated dataset and produce a model artifact you can later deploy or use for inference.

reflex training start

Kick off a training run.

reflex training start --dataset ds_abc123
FlagDefaultDescription
--datasetrequiredDataset ID from reflex datasets register.
--base-modelpi0.5Base model to fine-tune. Only pi0.5 is currently supported.
--trainableloralora or full.
--epochs3Number of training epochs.
--model-nameautoName for the resulting artifact.
--model-versionautoVersion label, e.g. v1.
--parameters-jsonJSON literal or @path/to/file.json for extra hyperparameters.
--request-idIdempotency key. Re-running with the same ID returns the existing run instead of creating a new one.
--jsonoffJSON output.

Passing hyperparameters from a file:

reflex training start \
  --dataset ds_abc123 \
  --trainable lora \
  --parameters-json @params.json

Sample response:

{
  "ok": true,
  "trainingRun": {
    "id": "tr_...",
    "status": "queued",
    "datasetId": "ds_abc123",
    "modelName": "...",
    "modelVersion": "..."
  },
  "next": ["reflex training status <training-run-id> --watch"]
}

reflex training status

Check the status of a run.

reflex training status tr_abc123
reflex training status tr_abc123 --watch
FlagDefaultDescription
--watchoffPoll until the run reaches a terminal status.
--poll-interval10.0Seconds between polls when --watch is set.
--jsonoffJSON output.

Terminal statuses: succeeded, failed, stopped.

reflex training list

List training runs in your organization.

reflex training list
reflex training list --all

By default this returns active runs plus runs that failed within the last 15 minutes. Pass --all to include the full history.

reflex training stop

Halt a running training run.

reflex training stop tr_abc123

The run transitions through stopping to stopped. Any artifact already checkpointed remains available.