dimensionalOS / dimos

The Agentive Operating System for Physical Space Hardware • Installation • Agent CLI & MCP • Blueprints • Development ⚠️ **Pre-Release Beta** ⚠️ Intro Dimensional is the modern operating system for generalist robotics. We are setting the next-generation SDK standard, integrating with the majority of robot manufacturers. With a simple install and no ROS required, build physical applications entirely in python that run on any humanoid, quadruped, or drone. Dimensional is agent native -- "vibecode" your robots in natural language and build (local & hosted) multi-agent systems that work seamlessly with your hardware. Agents run as native modules — subscribing to any embedded stream, from perception (lidar, camera) and spatial memory down to control loops and motor drivers. Navigation and Mapping SLAM, dynamic obstacle avoidance, route planning, and autonomous exploration — via both DimOS native and ROS Watch video Perception Detectors, 3d projections, VLMs, Audio processing Agentive Control, MCP "hey Robot, go find the kitchen" Watch video Spatial Memory Spatio-temporal RAG, Dynamic memory, Object localization and permanence Watch video Hardware Quadruped Humanoid Arm Drone Misc 🟩 Unitree Go2 pro/air 🟥 Unitree B1 🟨 Unitree G1 🟨 Xarm 🟨 AgileX Piper 🟧 MAVLink 🟧 DJI Mavic 🟥 Force Torque Sensor 🟩 stable 🟨 beta 🟧 alpha 🟥 experimental > [!IMPORTANT] > 🤖 Direct your favorite Agent (OpenClaw, Claude Code, etc.) to AGENTS.md and our CLI and MCP interfaces to start building powerful Dimensional applications. Installation Interactive Install > See for non-interactive and advanced options. Manual System Install To set up your system dependencies, follow one of these guides: • 🟩 Ubuntu 22.04 / 24.04 • 🟩 NixOS / General Linux • 🟧 macOS > Full system requirements, tested configs, and dependency tiers: docs/requirements.md Python Install Quickstart Featured Runfiles | Run command | What it does | |-------------|-------------| | | Quadruped navigation replay — SLAM, costmap, A* planning | | | Quadruped temporal memory replay | | | Quadruped agentic + MCP server in simulation | | | Humanoid in MuJoCo simulation | | | Drone video + telemetry replay | | | Drone + LLM agent with flight skills (replay) | | | Webcam demo — no hardware needed | | | Keyboard teleop with mock xArm7 (requires extra) | | | Quadruped agentic with local LLM (requires Ollama + ) | > Full blueprint docs: docs/usage/blueprints.md Agent CLI and MCP The CLI manages the full lifecycle — run blueprints, inspect state, interact with agents, and call skills via MCP. > Full CLI reference: docs/usage/cli.md Usage Use DimOS as a Library See below a simple robot connection module that sends streams of continuous to the robot and receives to a simple module. DimOS Modules are subsystems on a robot that communicate with other modules using standardized messages. Blueprints Blueprints are instructions for how to construct and wire modules. We compose them with , which connects streams by and returns a . Blueprints can be composed, remapped, and have transports overridden if fails due to conflicting variable names or and message types. A blueprint example that connects the image stream from a robot to an LLM Agent for reasoning and action execution. Library API • Modules • LCM • Blueprints • Transports — LCM, SHM, DDS, ROS 2 • Data Streams • Configuration • Visualization Demos Development Develop on DimOS Multi Language Support Python is our glue and prototyping language, but we support many languages via LCM interop. Check our language interop examples: • C++ • Lua • TypeScript