This guide covers installing the roz CLI, pulling a simulation container, and configuring an LLM provider so the agent can reason about your robot.
Prerequisites
| Requirement | Minimum |
|---|
| Rust | 1.92 or later (rustup.rs) |
| Docker | Docker Desktop or Docker Engine (docker.com) |
| LLM API key | Anthropic, OpenAI, Google, or local Ollama |
Docker must be running before you start a simulation. The code editor, agent runtime, and WASM sandbox work without Docker, but you need a sim container to actually control a robot.
Install the CLI
Install from crates.io:
Or clone and build from source:
git clone https://github.com/BedrockDynamics/roz-oss.git
cd roz-oss
cargo install --path crates/roz-cli
Pull a Sim Container
Each supported robot has a Docker sim container that bundles Gazebo, the robot’s middleware stack, and an MCP server. Pull the one you want to use:
Manipulator (UR5)
Drone (PX4)
Drone (ArduPilot)
Mobile (Nav2)
docker pull bedrockdynamics/substrate-sim:ros2-manipulator
move_to_pose, get_joint_state, stop_arm. WASM channels: 6 joint velocities.docker pull bedrockdynamics/substrate-sim:px4-gazebo-humble
takeoff, land, go_to. WASM channels: 4 body velocities.docker pull bedrockdynamics/substrate-sim:ardupilot-gazebo
arm, takeoff, go_to. WASM channels: 4 body velocities.docker pull bedrockdynamics/substrate-sim:ros2-nav2
navigate_to, follow_waypoints. WASM channels: 2 twist components. Anthropic (Claude)
OpenAI (GPT-4)
Google (Gemini)
Ollama (Local)
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
export GOOGLE_API_KEY=...
Start the Ollama server (no API key needed):Set the provider when launching:Local models vary in their ability to generate valid WAT code. For best results with WASM controllers, use a cloud provider. Ollama works well for MCP-tool-only workflows.
Verify Everything
Run the built-in diagnostic to check that all dependencies are configured correctly:
This checks for:
- Rust toolchain version
- Docker availability and daemon status
- LLM provider connectivity
- Sim container images on disk
If everything passes, you are ready to start. Head to the Quick Start to control your first robot. 
