# luigidu45/aloha-home architecture

> Architecture diagram of the GitHub repository luigidu45/aloha-home, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/luigidu45/aloha-home
- Repository: https://github.com/luigidu45/aloha-home

## Overview

DimOS is an agent-oriented robotics operating system: users launch robot applications, whose modules connect sensing, spatial understanding, planning, and control to simulated or physical hardware. The graph also includes documented agent/MCP, manipulation, and spatial-memory capabilities. The README describes these capabilities at product level; several implementation paths are therefore represented by their enclosing directories, and unsampled internal links are omitted rather than inferred.

Main entry points: [`dimos/control/coordinator.py`](https://github.com/luigidu45/aloha-home/blob/main/dimos/control/coordinator.py) (Control coordinator), [`dimos/core/module.py`](https://github.com/luigidu45/aloha-home/blob/main/dimos/core/module.py) (Module runtime), [`dimos/agents`](https://github.com/luigidu45/aloha-home/tree/main/dimos/agents) (LLM agents), [`dimos/cli/dimos.py`](https://github.com/luigidu45/aloha-home/blob/main/dimos/cli/dimos.py) (DimOS CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Module runtime"]
  node_cli["DimOS CLI<br/>[dimos.py]"]
  node_blueprints["Blueprint configuration<br/>[blueprints.py]"]
  node_module["Module runtime<br/>[module.py]"]
  node_workers["Python workers"]
  node_streams["Typed streams<br/>[stream.py]"]
  node_globalconfig["Global configuration<br/>[global_config.py]"]
end

subgraph group_robotics["Robot autonomy"]
  node_sensors["Robot sensors"]
  node_perception["Perception models"]
  node_mapping["Mapping and SLAM"]
  node_navigation["Navigation planners"]
  node_control["Control coordinator<br/>[coordinator.py]"]
  node_trajectory["Trajectory task<br/>[trajectory_task.py]"]
  node_robot["Robot hardware"]
  node_simulation["MuJoCo simulation<br/>[mujoco_engine.py]"]
end

subgraph group_agent["Agents and tools"]
  node_agents["LLM agents"]
  node_skills["Agent skills and MCP"]
end

subgraph group_manipulation["Manipulation"]
  node_manipulation["Manipulation planning"]
  node_execution["Trajectory execution"]
end

subgraph group_memory["Spatial memory"]
  node_memory[("Spatial memory")]
end

node_user(("Robot developer"))
node_operator(("Robot operator"))

node_user -->|"launches"| node_cli
node_cli -->|"runs blueprints"| node_blueprints
node_blueprints -.->|"configures modules"| node_module
node_module -->|"deploys modules"| node_workers
node_module -->|"publishes and subscribes"| node_streams
node_module -->|"uses configuration"| node_globalconfig
node_sensors -.->|"provides sensor data"| node_perception
node_perception -.->|"informs spatial understanding"| node_mapping
node_mapping -->|"supports route planning"| node_navigation
node_navigation -.->|"guides robot motion"| node_control
node_control -->|"dispatches tasks"| node_trajectory
node_control -->|"commands hardware"| node_robot
node_control -.->|"controls simulation"| node_simulation
node_operator -->|"requests actions"| node_agents
node_agents -->|"uses skills and MCP"| node_skills
node_agents -->|"subscribes to streams"| node_streams
node_manipulation -.->|"generates plans for"| node_execution
node_execution -->|"executes trajectories through"| node_control
node_memory -.->|"supports agent context"| node_agents
node_operator -.->|"reviews recorded data"| node_memory

click node_cli "https://github.com/luigidu45/aloha-home/blob/main/dimos/cli/dimos.py"
click node_blueprints "https://github.com/luigidu45/aloha-home/blob/main/dimos/core/coordination/blueprints.py"
click node_module "https://github.com/luigidu45/aloha-home/blob/main/dimos/core/module.py"
click node_workers "https://github.com/luigidu45/aloha-home/blob/main/dimos/core/coordination/worker_manager_python.py"
click node_streams "https://github.com/luigidu45/aloha-home/blob/main/dimos/core/stream.py"
click node_globalconfig "https://github.com/luigidu45/aloha-home/blob/main/dimos/core/global_config.py"
click node_sensors "https://github.com/luigidu45/aloha-home/tree/main/dimos/hardware/sensors"
click node_perception "https://github.com/luigidu45/aloha-home/tree/main/dimos/models"
click node_mapping "https://github.com/luigidu45/aloha-home/tree/main/dimos/mapping"
click node_navigation "https://github.com/luigidu45/aloha-home/tree/main/dimos/navigation"
click node_control "https://github.com/luigidu45/aloha-home/blob/main/dimos/control/coordinator.py"
click node_trajectory "https://github.com/luigidu45/aloha-home/blob/main/dimos/control/tasks/trajectory_task/trajectory_task.py"
click node_robot "https://github.com/luigidu45/aloha-home/tree/main/dimos/hardware"
click node_simulation "https://github.com/luigidu45/aloha-home/blob/main/dimos/simulation/engines/mujoco_engine.py"
click node_agents "https://github.com/luigidu45/aloha-home/tree/main/dimos/agents"
click node_skills "https://github.com/luigidu45/aloha-home/tree/main/dimos/agents/skills"
click node_manipulation "https://github.com/luigidu45/aloha-home/tree/main/dimos/manipulation/planning"
click node_execution "https://github.com/luigidu45/aloha-home/blob/main/dimos/manipulation/execution_manager.py"
click node_memory "https://github.com/luigidu45/aloha-home/tree/main/dimos/memory"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_blueprints,node_module,node_workers,node_streams,node_globalconfig toneBlue
class node_sensors,node_perception,node_mapping,node_navigation,node_control,node_trajectory,node_robot,node_simulation toneAmber
class node_agents,node_skills toneMint
class node_manipulation,node_execution toneRose
class node_memory,node_user,node_operator toneIndigo
```

## Components

### Module runtime

- [DimOS CLI](https://github.com/luigidu45/aloha-home/blob/main/dimos/cli/dimos.py): `dimos/cli/dimos.py`
- [Blueprint configuration](https://github.com/luigidu45/aloha-home/blob/main/dimos/core/coordination/blueprints.py): `dimos/core/coordination/blueprints.py`
- [Module runtime](https://github.com/luigidu45/aloha-home/blob/main/dimos/core/module.py): `dimos/core/module.py`
- [Python workers](https://github.com/luigidu45/aloha-home/blob/main/dimos/core/coordination/worker_manager_python.py): `dimos/core/coordination/worker_manager_python.py`
- [Typed streams](https://github.com/luigidu45/aloha-home/blob/main/dimos/core/stream.py): `dimos/core/stream.py`
- [Global configuration](https://github.com/luigidu45/aloha-home/blob/main/dimos/core/global_config.py): `dimos/core/global_config.py`

### Robot autonomy

- [Robot sensors](https://github.com/luigidu45/aloha-home/tree/main/dimos/hardware/sensors): `dimos/hardware/sensors`
- [Perception models](https://github.com/luigidu45/aloha-home/tree/main/dimos/models): `dimos/models`
- [Mapping and SLAM](https://github.com/luigidu45/aloha-home/tree/main/dimos/mapping): `dimos/mapping`
- [Navigation planners](https://github.com/luigidu45/aloha-home/tree/main/dimos/navigation): `dimos/navigation`
- [Control coordinator](https://github.com/luigidu45/aloha-home/blob/main/dimos/control/coordinator.py): `dimos/control/coordinator.py`
- [Trajectory task](https://github.com/luigidu45/aloha-home/blob/main/dimos/control/tasks/trajectory_task/trajectory_task.py): `dimos/control/tasks/trajectory_task/trajectory_task.py`
- [Robot hardware](https://github.com/luigidu45/aloha-home/tree/main/dimos/hardware): `dimos/hardware`
- [MuJoCo simulation](https://github.com/luigidu45/aloha-home/blob/main/dimos/simulation/engines/mujoco_engine.py): `dimos/simulation/engines/mujoco_engine.py`

### Agents and tools

- [LLM agents](https://github.com/luigidu45/aloha-home/tree/main/dimos/agents): `dimos/agents`
- [Agent skills and MCP](https://github.com/luigidu45/aloha-home/tree/main/dimos/agents/skills): `dimos/agents/skills`

### Manipulation

- [Manipulation planning](https://github.com/luigidu45/aloha-home/tree/main/dimos/manipulation/planning): `dimos/manipulation/planning`
- [Trajectory execution](https://github.com/luigidu45/aloha-home/blob/main/dimos/manipulation/execution_manager.py): `dimos/manipulation/execution_manager.py`

### Spatial memory

- [Spatial memory](https://github.com/luigidu45/aloha-home/tree/main/dimos/memory): `dimos/memory`

### Other components

- **Robot developer**
- **Robot operator**

## Connections

- Robot developer → DimOS CLI: launches (evidence: `README.md`)
- DimOS CLI → Blueprint configuration: runs blueprints (evidence: `README.md`)
- Blueprint configuration → Module runtime: configures modules (evidence: `dimos/core/module.py`)
- Module runtime → Python workers: deploys modules (evidence: `dimos/core/coordination/worker_manager_python.py`)
- Module runtime → Typed streams: publishes and subscribes (evidence: `dimos/core/module.py`)
- Module runtime → Global configuration: uses configuration (evidence: `dimos/core/module.py`)
- Robot sensors → Perception models: provides sensor data
- Perception models → Mapping and SLAM: informs spatial understanding (evidence: `dimos/mapping/osm/query.py`)
- Mapping and SLAM → Navigation planners: supports route planning (evidence: `README.md`)
- Navigation planners → Control coordinator: guides robot motion
- Control coordinator → Trajectory task: dispatches tasks (evidence: `dimos/control/coordinator.py`)
- Control coordinator → Robot hardware: commands hardware (evidence: `README.md`)
- Control coordinator → MuJoCo simulation: controls simulation
- Robot operator → LLM agents: requests actions (evidence: `README.md`)
- LLM agents → Agent skills and MCP: uses skills and MCP (evidence: `README.md`)
- LLM agents → Typed streams: subscribes to streams (evidence: `README.md`)
- Manipulation planning → Trajectory execution: generates plans for (evidence: `dimos/manipulation/execution_manager.py`)
- Trajectory execution → Control coordinator: executes trajectories through (evidence: `dimos/manipulation/execution_manager.py`)
- Spatial memory → LLM agents: supports agent context
- Robot operator → Spatial memory: reviews recorded data
