Responsibility
Small, runnable starting points that use ORA's current defaults: a smoke test of the quickstart, the official-suite cell lists, and a host-profile template. They show how to drive ORA; they do not reproduce an archived experiment's score.
| Example | Purpose |
|---|---|
uv run --locked ora run --env synthetic |
Real model API, no simulator or GPU; see the quickstart. |
uv run --locked python -m examples.quickstart_smoke [--keep DIR] |
The same command against a deterministic local HTTP model: it resolves, preflights, leases, supervises, evaluates and seals one episode without an API key, a simulator or a GPU; CI runs it. --keep DIR keeps the run in the workspace DIR and prints its run ID and the ora watch command that replays it. |
| official_suite | List, compose and queue the official LIBERO-Pro and RoboTwin suite cells on the default composition (run.py, scheduler.py, experiment.yaml). |
| tasks/robodojo-toolkit-v6.yaml | A task file (ora.task.v1) on RoboDojo's default toolkit surface v6: `ora task resolve |
| hosts/example-host.yaml | Template of an execution host profile: copy it to ora/orchestrator/hosts/<id>.yaml (or a directory named by ORA_HOSTS_DIR) and export ORA_EXECUTION_HOST=<id>. |
| LIBERO recipe | Install and compose one Panda episode. |
| RoboTwin recipe | Install and compose one dual-arm episode. |
| RoboDojo recipe | Install and compose one Isaac Sim episode. |
What belongs here, and what does not
Here: examples that a reader copies or runs as they are, against the current
defaults. Not here: reusable behaviour (it belongs in ora/, and an example
calls it), new experiments with their own launchers and results, model keys
and generated runs (keep them outside Git; outputs/ is ignored).
Dependency direction
Examples import ora and call the ora command; ora never imports
examples. Tests may import the shipped examples (tests/ imports ora,
viewer, examples and tests.support only).
Entry points
uv run --locked python -m examples.quickstart_smoke [--keep DIR](from the checkout; a Python without ORA's environment stops and says so)python examples/official_suite/run.py {cells,compose,services,queue}: list the official-suite cells, write one cell's RunSpec, qualify the resident services and queue the cells across lanes.