Skip to main content
In fifteen minutes you will: install DimOS, replay a recorded Unitree Go2 session in the Rerun viewer with no hardware, and then run the same stack on a real Go2. This page is geared toward the Unitree Go2. If you were given a Galaxea A1Z arm instead, start with the A1Z guide. If you use coding agents (Claude Code, OpenClaw, or similar), point them at AGENTS.md in the repo.

​
System requirements

GPU is required only for perception, VLMs, and AI features. Optional for basic robot control and everything on this page.

​
Step 1: Install

DimOS supports Python 3.10 to 3.12 and targets 3.12. The examples use uv; plain python -m venv and pip work too.
This is an editable install from the repo: you get the dimos CLI for everything below, and you can open the code and write your own skills and blueprints right away. Extras keep installs lean: base is the runtime, modules, transports, and CLI; unitree adds WebRTC and skills for Go2 / G1 (real or replayed).
One-command interactive install (system deps + Python env):
Or install system dependencies yourself with the guide for your OS: Ubuntu (primary tested path), macOS (Homebrew-based, less mature than Linux).

​
Step 2: Replay a recorded session (no hardware)

A Rerun viewer window opens showing the robot’s camera, the live-built map, and the planned paths from a recorded office navigation session, with SLAM, costmap, and A-star planning running for real against the recorded sensors. On first run the window may stay black briefly while roughly 75 MB of recorded data downloads. While it runs, try the ops commands from a second terminal:

​
Step 3: Real robot

For a physical Unitree Go2 over WebRTC, set the robot’s IP:
Newer Go2 firmware encrypts the connection. If you were given an AES key, set it the same way (robots on older firmware only need ROBOT_IP):
Then run the Go2 blueprint:
Do not skip the platform guide - network setup, latency, and safety habits matter: Unitree Go2. For other hardware, see Platforms in the sidebar, including the Galaxea A1Z arm.

​
More things to run

dimos list prints every available blueprint. Blueprint reference: Blueprints.

​
What next?

How DimOS fits together

The mental model: modules, streams, and blueprints behind every workflow.

Agents

Natural language control: skills, MCP, and how to add your own.

Platforms

Bring-up guides: Unitree Go2, G1, and manipulator arms.

Memory

The three memory systems and what each is for.