Skip to main content

cirron run

Manage training runs, pipeline executions, batch inference, and hyperparameter sweeps. The run command provides subcommands for triggering, monitoring, and managing compute jobs on the Cirron platform.

Usage

Subcommands

SubcommandDescription
pipeline [name]Trigger a pipeline run
jobExecute a single-task job
inference [deployment]Trigger batch inference
sweepTrigger hyperparameter sweep
listList all runs and jobs
status <runId>Get run status
cancel <runId>Cancel a running job
logs <runId>Stream run logs

Pipeline

Trigger a pipeline run by name with optional configuration.

Pipeline Options

OptionDescriptionDefault
-c, --config <file>Pipeline config file (YAML/JSON)-
--gpu <type>GPU type override-
--priority <level>Job priority (low, normal, high, critical)normal
--tag <tags>Comma-separated run tags-
--dry-runShow what would execute without runningfalse
--watchStream output and wait for completionfalse

Examples

Job

Execute a single-task job.

Job Options

OptionDescriptionDefault
-c, --config <file>Job config file-
--gpu <type>GPU type override-
--priority <level>Job prioritynormal
--dry-runShow what would execute without runningfalse

Inference

Trigger batch inference on a deployment.

Inference Options

OptionDescriptionDefault
-i, --input <path>Input data path-
-o, --output <path>Output path-
--model <name>Model name/version to use-
--batch-size <n>Batch size override-
--watchStream outputfalse

Sweep

Trigger a hyperparameter sweep.

Sweep Options

OptionDescriptionDefault
-c, --config <file>Sweep config file-
--trials <n>Number of trials-
--parallel <n>Max parallel trials-
--strategy <type>Search strategy (grid, random, bayesian)-
--watchStream outputfalse

List

List all runs and jobs.

List Options

OptionDescriptionDefault
--status <status>Filter by status (running, completed, failed, cancelled)-
--last <n>Show last N runs-
--pipeline <name>Filter by pipeline-
--jsonOutput in JSON formatfalse
Runs are also accessible via cirron list runs.

Status

Check the status of a specific run.

Status Options

OptionDescriptionDefault
--jsonOutput in JSON formatfalse
--watchPoll for updatesfalse

Cancel

Cancel a running job.

Cancel Options

OptionDescriptionDefault
--forceForce cancel without confirmationfalse

Logs

Stream logs for a run.

Logs Options

OptionDescriptionDefault
-f, --followFollow log outputfalse
-n, --lines <number>Number of lines to show-

Examples

Training Workflow

Batch Inference