Rollouts

A rollout is the unit of agent behavior that Osmosis evaluates and trains. It wires together an AgentWorkflow, which defines how the agent handles a prompt, calls the model, and uses tools, and a Grader, which scores each result into a numerical reward. When you submit an evaluation run or a training run, the platform executes the rollout once per dataset row and grades what it produces. In the Multiply Quickstart, multiply-local-openai is a rollout: its AgentWorkflow asks the model to solve a multiplication prompt, and its Grader compares the answer to the row’s ground_truth.

What a Rollout Contains

Rollouts are code in your workspace repository, one directory per rollout under rollouts/, referenced by evaluation and training configs:

repository/
├── rollouts/
│   └── my-rollout/
│       ├── main.py        # explicit workflow, grader, config, and backend wiring
│       └── pyproject.toml # rollout-local dependencies
├── configs/
│   ├── eval/
│   │   └── my-rollout.toml
│   └── training/
│       └── my-rollout.toml
└── data/
    └── test.jsonl

Piece	Role	Learn more
`AgentWorkflow`	Defines agent behavior: prompt handling, model calls, and tool use	AgentWorkflow
`Grader`	Turns each result into the reward signal that drives training	Grader
Eval and training configs	Point runs at the rollout, entrypoint, model, and platform dataset	Configuration Files

For the full rollout definition — including execution backends and how rollouts fit the training loop — see the SDK Overview.

The Rollouts Page

The Platform Rollouts page lists every rollout discovered from your connected workspace repository. Git Sync scans the rollouts/ directory of each pushed branch, and each subdirectory becomes an entry showing its name, last synced commit, and last synced time. Selecting a rollout opens its source on GitHub at the synced commit. Each branch has its own rollout catalog. The branch picker selects the repository default branch first.

The Rollouts page requires a connected workspace repository. If no repository is connected, set one up from Git Integration — see Onboarding.

Create a Rollout

Rollouts are created in code rather than in the dashboard. New Rollout shows the CLI command that scaffolds one in your local workspace clone:

osmosis rollout init <name>

Commit and push the generated files; the rollout appears on the Rollouts page after the branch syncs. You can also list synced rollouts from the CLI:

osmosis rollout list [--branch NAME]

To build a rollout for your own task with an AI coding agent, follow the Custom Rollout Guide.

Next Steps

SDK Overview

Understand the rollout definition, core abstractions, and the training loop.

Custom Rollout Guide

Create a task-specific rollout with the workspace Agent Skills.

Git Sync

Learn how pushed branches populate the rollout catalog.

Command Reference

Review rollout init and rollout list options.

Get started

Runs

Resources

Workspace

What a Rollout Contains

The Rollouts Page

Create a Rollout

Next Steps

SDK Overview

Custom Rollout Guide

Git Sync

Command Reference

​What a Rollout Contains

​The Rollouts Page

​Create a Rollout

​Next Steps

SDK Overview

Custom Rollout Guide

Git Sync

Command Reference

What a Rollout Contains

The Rollouts Page

Create a Rollout

Next Steps