Guide

Launch a workflow

Choose a session mode, describe the simulation, let the agent build and judge it, then inspect the result. A first run takes a few minutes.

Open the workflow builder →
01

Open the workflow builder

Sign in, choose Workflows, then New run. Public CTAs route through login and return directly to /workflows/new.

02

Choose where the agent works

New session for a fresh managed Isaac runtime, Existing session to attach to a ready session, or From env to start from a saved environment.

03

Write the simulation prompt

Describe the scene, robot, task, and success criteria. Keep prompts concrete: assets, positions, motions, constraints, and what the judge should verify.

04

Set the turn budget

Use a larger turn budget for rich scenes. Builder and judge attempts consume turns, so raise the budget for large or multi-step simulations.

05

Run and watch the trace

The run page shows allocation, sandbox startup, builder/judge progress, recent events, and the embedded viewer.

06

Use the result

Completed runs link back to the session and report saved USD paths, environment ids, screenshots, traces, and tool-call counts.

Guide

Operate a session

A session is the live Isaac Sim workspace: direct control, a browser viewer, session-scoped MCP tools, environment snapshots, and lifecycle actions.

View your sessions →
01

Start a session

Open Sessions and choose Start session. Pick a blank Isaac workspace, or start from a saved environment version.

02

Wait for Isaac readiness

The list and detail pages distinguish control-plane status from Isaac runtime readiness. Open the viewer only after Isaac is ready.

03

Open the WebRTC viewer

Use Open WebRTC viewer from the list or the viewer card on the detail page. If the browser blocks the popup, open the detail page first.

04

Connect tools

The detail page exposes SSH and Claude Code/MCP setup when supported. Copy commands from the page rather than inventing hostnames.

05

Save the workspace

For blank sessions, Save as environment creates a reusable environment. For environment-backed sessions, Publish creates a new version.

06

Sleep, wake, extend, or stop

Warm-pool sessions can sleep and wake. Direct sessions can be extended. Stop when done.

Python SDK

Install, login, doctor, train.

The SDK book covers installation, authentication, readiness checks, training loops, examples, and Behavior CI.

terminal
$ uv add "cybernetic-physics @ git+https://.../cybernetic.git"
$ cybernetics auth login
$ cybernetics doctor --require-rl
$ python examples/dreamzero_sft_smoke.py --remote-run

API reference

REST API

Base URL https://api.cyberneticphysics.com/v1. Authenticate with Authorization: Bearer YOUR_API_KEY.

Workflows
GET

/workflows/definitions

List code-shipped workflow definitions and launch metadata.

GET

/workflows/definitions/:kind

Read one definition, including form fields, default budget, and step labels.

POST

/workflows/runs

Create a workflow run for the active workspace.

GET

/workflows/runs

List runs, optionally filtered by status or workspace.

GET

/workflows/runs/:id

Read status, current step, session id, viewer URL, result fields, and errors.

GET

/workflows/events

Stream live workflow run snapshots for one workspace.

GET

/workflows/runs/:id/events

Stream resumable live events for one workflow run.

GET

/workflows/runs/:id/events/recent

Read recent workflow events as a JSON recovery path.

POST

/workflows/runs/:id/cancel

Cancel a queued or running workflow.

Sessions
POST

/sessions

Start a new session, restart from another, or start from an environment version.

GET

/sessions

List sessions for a workspace with pagination and status filtering.

GET

/sessions/:id

Read status, runtime readiness, viewer URL, SSH access, cost, and lineage.

POST

/sessions/:id/keepalive

Extend idle timeout for direct sessions.

POST

/sessions/:id/sleep

Persist and sleep a ready warm-pool session.

POST

/sessions/:id/wake

Wake a sleeping warm-pool session back onto capacity.

POST

/sessions/:id/save-as-environment

Save a blank session workspace as a new reusable environment.

POST

/sessions/:id/stop

Stop an active session and release its compute.