sagax
Frontend

CLI

The CLI frontend provides a simple interface to run jobs and exposes the task execution engine through a few commands.

Plans

Plans specify jobs and can be written as YAML. Each job specifies a task and its configuration. The configuration is validated against the task's schema and passed to the task handler when creating the trials.

jobs:
  hello-world:
    id: run-command
    config:
      image_id: ubuntu:24.04
      command: 'echo "hello from trial {trial}"'
    trials: 2

You can create all the jobs from this plan and run them using sagax run:

cargo run -p my-sagax-cli run plan.yaml

Jobs

You can run jobs without creating plan files using sagax job create:

cargo run -p my-sagax-cli job create run-command --config-json '{image_id:"ubuntu:24.04", command: "echo \"hello world\"}' --trials 2

On this page