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: 2You can create all the jobs from this plan and run them using sagax run:
cargo run -p my-sagax-cli run plan.yamlJobs
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