# dimos | Dimensional | Knowledge Base | Instagit

Dimensional is the agentic operating system for physical space. Vibecode humanoids, quadrupeds, drones, and other hardware platforms in natural language and build multi-agent systems that work seamlessly with physical input (cameras, lidar, actuators).

GitHub Stars: 1k

Repository: https://github.com/dimensionalOS/dimos

---

## Articles

### [How to Use McpClient to Connect External Agents to DimOS Blueprints](/dimensionalOS/dimos/how-can-i-use-mcpclient-to-connect-external-agents-to-running-dimos-blueprints)

Learn how to use McpClient to connect external agents to DimOS blueprints. Expose blueprint skills as JSON-RPC tools and integrate LLM-based agents seamlessly.

- Tags: how-to-guide
- Published: 2026-03-15

### [How Robot Temporal States Are Managed Using Memory Modules in DimOS](/dimensionalOS/dimos/how-are-robot-temporal-states-managed-using-memory-modules-in-dimos)

Discover how DimOS manages robot temporal states using TemporalMemory orchestrator and thread-safe containers for LLM agent historical context across runs.

- Tags: internals
- Published: 2026-03-15

### [How to Convert ROS Messages to LCM in DimOS for Cross-Language Interoperability](/dimensionalOS/dimos/how-can-i-convert-ros-messages-to-lcm-for-cross-language-interoperability-in-dimos)

Learn how to convert ROS messages to LCM in DimOS using the Bridge class for seamless cross-language interoperability. Discover the simple steps to establish communication.

- Tags: how-to-guide
- Published: 2026-03-15

### [How to Set Up Docker Deployment for DimOS Robotics Applications: Complete Guide](/dimensionalOS/dimos/how-do-i-set-up-docker-deployment-for-dimos-robotics-applications)

Discover how to set up Docker deployment for DimOS robotics applications. Follow our guide to create reproducible ROS 2 environments using a layered Docker image architecture and helper build script.

- Tags: how-to-guide
- Published: 2026-03-15

### [Debugging Daemonized Blueprints by Inspecting Logs in DimOS](/dimensionalOS/dimos/what-are-the-best-practices-for-debugging-daemonized-blueprints-by-inspecting-logs)

Master debugging daemonized blueprints in DimOS. Inspect structured JSON logs with dimos log CLI and isolate runs in per-run directories for efficient troubleshooting.

- Tags: best-practices
- Published: 2026-03-15

### [How to Write pytest Tests for DimOS Inter-Process Communication (IPC) Channels](/dimensionalOS/dimos/how-can-i-write-pytest-tests-for-module-inter-process-communication-ipc)

Learn to write pytest tests for dimOS IPC channels. Use make_frame_channel in fixtures to validate data integrity and cross-process attachment with descriptor API.

- Tags: testing
- Published: 2026-03-15

### [How to Manage Configuration Using pydantic BaseSettings in DimOS](/dimensionalOS/dimos/what-is-the-recommended-way-to-manage-configuration-using-pydantic-basesettings-in-dimos)

Learn how to manage configuration in DimOS using pydantic BaseSettings. Centralize runtime settings from environment variables CLI flags and programmatic overrides into a single typed source of truth.

- Tags: how-to-guide
- Published: 2026-03-15

### [How to Implement Custom Perception Detectors Utilizing VLM Models in DimOS](/dimensionalOS/dimos/how-to-implement-custom-perception-detectors-utilizing-vlm-models)

Learn to implement custom perception detectors using VLM models in DimOS. Leverage the VlModel abstraction to build powerful custom perception capabilities with query detections and points.

- Tags: how-to-guide
- Published: 2026-03-15

### [Available Viewer Backends in DimOS: Rerun, Foxglove, and None Explained](/dimensionalOS/dimos/what-are-the-available-viewer-backends-in-dimos-rerun-foxglove-none)

Explore DimOS viewer backends like rerun, foxglove, and none. Learn how to configure visualization rendering with GlobalConfig settings in this technical guide.

- Tags: tutorial
- Published: 2026-03-15

### [How to Create Spatial Memory for Persistent Robot Navigation Using RAG in DimoS](/dimensionalOS/dimos/how-can-i-create-spatial-memory-for-persistent-robot-navigation-using-rag)

Create persistent robot spatial memory for navigation using RAG. DimoS converts video and odometry into a semantic vector database empowering LLMs for robust robot restarts.

- Tags: how-to-guide
- Published: 2026-03-15

### [How to Build Replay Pipelines from Recorded Sensor Data for Robots with DimOS](/dimensionalOS/dimos/how-to-build-replay-pipelines-from-recorded-sensor-data-for-robots)

Learn to build robot replay pipelines from recorded sensor data with DimOS. Replay sensor streams via timestamped pickle files and Rx-observable pipelines without code changes.

- Tags: how-to-guide
- Published: 2026-03-15

### [How to Integrate ROS2 Topics into DimOS Using the ROSTransport Bridge](/dimensionalOS/dimos/how-do-i-integrate-ros2-topics-into-dimos-using-the-rostansport-bridge)

Integrate ROS2 topics into DimOS seamlessly. Learn to use the ROSTransport bridge by binding DimOS streams to ROSTransport instances and attaching them to blueprints. Simplify your robotics development.

- Tags: how-to-guide
- Published: 2026-03-15

### [How to Tune DimOS Performance Using n_workers and Shared Memory (SHM) Transports](/dimensionalOS/dimos/how-can-i-tune-performance-using-n-workers-and-shared-memory-shm-transports)

Tune dimensionalOS performance by increasing n_workers for parallel execution and using SHM transports for high-bandwidth streams reducing latency and network overhead.

- Tags: performance
- Published: 2026-03-15

### [Understanding the DimOS Spec Pattern for Type-Safe RPC Wiring](/dimensionalOS/dimos/what-is-the-spec-pattern-and-how-is-it-used-for-type-safe-rpc-wiring-between-dimos-modules)

Discover the DimOS Spec pattern for type-safe RPC wiring. Learn how this protocol-based interface system auto-connects modules with structural and annotation compliance.

- Tags: deep-dive
- Published: 2026-03-15

### [How to Configure Navigation Strategies in DimOS: A* Planning and Frontier Exploration](/dimensionalOS/dimos/how-to-configure-different-navigation-strategies-like-a-planning-and-frontier-exploration)

Configure A* planning and frontier exploration strategies in DimOS. Learn to set up goal-directed path planning and autonomous mapping using environment variables, constructor parameters, and blueprint composition.

- Tags: how-to-guide
- Published: 2026-03-15

### [How to Write LangGraph-Based Agents that Utilize Skill Containers in DimOS](/dimensionalOS/dimos/how-do-i-write-langgraph-based-agents-that-utilize-skill-containers)

Learn to write LangGraph-based agents in DimOS that leverage skill containers. Automatically convert @skill methods into LangChain tools for LLM-driven robot capabilities and compiled state graphs.

- Tags: how-to-guide
- Published: 2026-03-15

### [How to Add Support for New Robot Hardware to the DimOS Module System](/dimensionalOS/dimos/how-can-i-add-support-for-new-robot-hardware-to-the-dimos-module-system)

Learn how to add new robot hardware support to the DimOS module system. Implement an adapter register it and wrap it in a Module subclass for seamless integration.

- Tags: how-to-guide
- Published: 2026-03-15

### [How to Debug Module RPC Failures in DimOS When Using Forkserver Worker Processes](/dimensionalOS/dimos/how-to-debug-module-rpc-failures-when-using-forkserver-worker-processes)

Debug module RPC failures in DimOS with forkserver workers. Enable debug logs, verify RPC decorators, and check worker PIDs for crashed processes to resolve cryptic pipe errors.

- Tags: how-to-guide
- Published: 2026-03-15

### [How to Set Up the MCP Server for External LLM Agent Integration in DimOS](/dimensionalOS/dimos/how-do-i-set-up-the-mcp-server-for-external-llm-agent-integration)

Integrate external LLM agents with DimOS by setting up the MCP server. Discover and invoke robot capabilities via JSON-RPC and HTTP POST requests to the /mcp endpoint.

- Tags: how-to-guide
- Published: 2026-03-15

### [DimOS GlobalConfig Fields Precedence Order: 5-Level Configuration Cascade](/dimensionalOS/dimos/what-is-the-precedence-order-for-globalconfig-fields-defaults-env-env-vars-cli-flags)

Understand DimOS GlobalConfig field precedence. Learn the 5-level configuration cascade: defaults, .env, env vars, blueprint overrides, and CLI flags. Discover the order that wins.

- Tags: architecture
- Published: 2026-03-15

### [How to Remap Blueprint Streams and Override Transport Layers (LCM, SHM, DDS, ROS 2) in DimOS](/dimensionalOS/dimos/how-can-i-remap-blueprint-streams-and-override-transport-layers-lcm-shm-dds-ros2)

Learn to remap Blueprint streams and override transport layers LCM SHM DDS ROS2 in DimOS using Blueprint.remappings() and Blueprint.transports(). Enhance your data communication.

- Tags: how-to-guide
- Published: 2026-03-15

### [How to Create Custom @skill Decorators with Schema Generation Rules for LLM Agents in DimOS](/dimensionalOS/dimos/how-to-create-custom-skill-decorators-with-schema-generation-rules-for-llm-agents)

Learn to create custom @skill decorators in DimOS for LLM agents. Automatically generate JSON schemas using type annotations and docstrings for seamless integration.

- Tags: how-to-guide
- Published: 2026-03-15

### [Supported Robot Connection Types in GlobalConfig: WebRTC, Simulation, and Replay](/dimensionalOS/dimos/what-are-the-supported-robot-connection-types-in-globalconfig-webrtc-simulation-replay)

Explore supported robot connection types in DimOS GlobalConfig: WebRTC for live hardware, MuJoCo for simulation, and Replay for recorded data. Learn how to configure your robot connections.

- Tags: documentation
- Published: 2026-03-15

### [How DimOS In[T] and Out[T] Streams Enable Inter-Module Communication](/dimensionalOS/dimos/how-do-dimos-in-t-and-out-t-streams-enable-inter-module-communication)

Learn how DimOS In[T] and Out[T] streams enable type-safe inter-module communication using Python type hints for zero-boilerplate publisher-subscriber wiring.

- Tags: internals
- Published: 2026-03-15