Open the workflow builder
Sign in, choose Workflows, then New run. Public CTAs route through login and return directly to /workflows/new.
Documentation
Workflows when you want an agent to build it, sessions when you want your hands on it, the SDK when you want to script it.
01 · Workflows
The highest-level path: a prompt in, a verified scene out.
02 · Sessions
A live GPU workspace you can save as a versioned environment.
03 · Python SDK
Install, authenticate, run readiness checks, launch training.
Guide
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 →Sign in, choose Workflows, then New run. Public CTAs route through login and return directly to /workflows/new.
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.
Describe the scene, robot, task, and success criteria. Keep prompts concrete: assets, positions, motions, constraints, and what the judge should verify.
Use a larger turn budget for rich scenes. Builder and judge attempts consume turns, so raise the budget for large or multi-step simulations.
The run page shows allocation, sandbox startup, builder/judge progress, recent events, and the embedded viewer.
Completed runs link back to the session and report saved USD paths, environment ids, screenshots, traces, and tool-call counts.
Guide
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 →Open Sessions and choose Start session. Pick a blank Isaac workspace, or start from a saved environment version.
The list and detail pages distinguish control-plane status from Isaac runtime readiness. Open the viewer only after Isaac is ready.
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.
The detail page exposes SSH and Claude Code/MCP setup when supported. Copy commands from the page rather than inventing hostnames.
For blank sessions, Save as environment creates a reusable environment. For environment-backed sessions, Publish creates a new version.
Warm-pool sessions can sleep and wake. Direct sessions can be extended. Stop when done.
Python SDK
The SDK book covers installation, authentication, readiness checks, training loops, examples, and Behavior CI.
$ 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
Base URL https://api.cyberneticphysics.com/v1. Authenticate with Authorization: Bearer YOUR_API_KEY.
/workflows/definitions
List code-shipped workflow definitions and launch metadata.
/workflows/definitions/:kind
Read one definition, including form fields, default budget, and step labels.
/workflows/runs
Create a workflow run for the active workspace.
/workflows/runs
List runs, optionally filtered by status or workspace.
/workflows/runs/:id
Read status, current step, session id, viewer URL, result fields, and errors.
/workflows/events
Stream live workflow run snapshots for one workspace.
/workflows/runs/:id/events
Stream resumable live events for one workflow run.
/workflows/runs/:id/events/recent
Read recent workflow events as a JSON recovery path.
/workflows/runs/:id/cancel
Cancel a queued or running workflow.
/sessions
Start a new session, restart from another, or start from an environment version.
/sessions
List sessions for a workspace with pagination and status filtering.
/sessions/:id
Read status, runtime readiness, viewer URL, SSH access, cost, and lineage.
/sessions/:id/keepalive
Extend idle timeout for direct sessions.
/sessions/:id/sleep
Persist and sleep a ready warm-pool session.
/sessions/:id/wake
Wake a sleeping warm-pool session back onto capacity.
/sessions/:id/save-as-environment
Save a blank session workspace as a new reusable environment.
/sessions/:id/stop
Stop an active session and release its compute.