# adyansh04/grove-g1 architecture

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

- Interactive diagram: https://gitdiagram.com/adyansh04/grove-g1
- Repository: https://github.com/adyansh04/grove-g1

## Overview

Grove-G1 is a ROS 2 autonomy stack for the Unitree G1, designed to run in simulation and on hardware. A mission behavior tree coordinates navigation, measured-object approach, and pick/place; the robot’s policy controller maintains balance while manipulation plans arm and hand motion. Other documented branches provide text-grounded perception, world-model exploration, and VLA-generated motion gated by the planning scene. The graph combines README-documented capabilities with sampled implementation evidence; several package internals and runtime connections were not sampled, so those links are documented rather than inferred from imports.

Main entry points: [`workspace/src/g1_orchestration/src/skills`](https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_orchestration/src/skills) (Mission skills), [`workspace/src/g1_perception/src`](https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_perception/src) (Object perception), [`workspace/src/g1_manipulation/src/manipulation_server`](https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_manipulation/src/manipulation_server) (Pick and place), [`servers/vision/server.py`](https://github.com/adyansh04/grove-g1/blob/main/servers/vision/server.py) (Vision service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mission["Mission skills"]
  node_bt["Behavior trees"]
  node_skills["Mission skills"]
  node_manip["Pick and place"]
end

subgraph group_perception["Perception and maps"]
  node_sensors["Sensor relay"]
  node_perception_nodes["Object perception"]
  node_vision_api["Vision service<br/>[server.py]"]
  node_segmentation["Text segmentation<br/>[segmentation.py]"]
  node_world["World model"]
end

subgraph group_motion["Navigation and motion"]
  node_approach["Object approach"]
  node_nav["Nav2 and SLAM"]
  node_odom["FAST-LIO odometry"]
  node_moveit["MoveIt planning"]
end

subgraph group_robot["Robot control"]
  node_hardware["Body hardware"]
  node_hands["Dex3 hand interface<br/>[g1_dex3_system.cpp]"]
  node_policy["Locomotion controller"]
  node_safety["Safety controller"]
end

subgraph group_learned["Learned policies"]
  node_vla["VLA action chunks<br/>[chunks.cpp]"]
  node_mock["Mock policy engine"]
end

node_operator(("Mission operator"))
node_canopy["Canopy service"]

node_operator -->|"starts mission"| node_bt
node_bt -.->|"ticks skills"| node_skills
node_skills -->|"requests navigation"| node_nav
node_skills -->|"requests approach"| node_approach
node_skills -->|"requests pick/place"| node_manip
node_manip -->|"plans motion"| node_moveit
node_sensors -->|"supplies LiDAR"| node_odom
node_odom -->|"provides odometry"| node_nav
node_sensors -.->|"supplies camera data"| node_perception_nodes
node_perception_nodes -->|"requests segmentation"| node_vision_api
node_vision_api -->|"dispatches requests"| node_segmentation
node_segmentation -->|"returns instances"| node_vision_api
node_perception_nodes -->|"provides object poses"| node_manip
node_canopy -->|"serves world model"| node_world
node_skills -.->|"queries world model"| node_world
node_policy -.->|"feeds joint targets"| node_safety
node_safety -.->|"writes commands"| node_hardware
node_moveit -->|"commands hand joints"| node_hands
node_vla -->|"checks action chunks"| node_moveit
node_mock -.->|"serves action chunks"| node_vla

click node_bt "https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_orchestration/src"
click node_skills "https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_orchestration/src/skills"
click node_manip "https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_manipulation/src/manipulation_server"
click node_approach "https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_locomotion/src/base_approach"
click node_nav "https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_navigation/launch"
click node_odom "https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_state_estimation/src"
click node_sensors "https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_sensor_relay/src"
click node_perception_nodes "https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_perception/src"
click node_vision_api "https://github.com/adyansh04/grove-g1/blob/main/servers/vision/server.py"
click node_segmentation "https://github.com/adyansh04/grove-g1/blob/main/servers/vision/segmentation.py"
click node_world "https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_orchestration/src/skills/world_model_leaves.cpp"
click node_moveit "https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_moveit_config/launch/move_group.launch.py"
click node_hardware "https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_hardware_interface/src/g1_lowcmd_system.cpp"
click node_hands "https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_hand_interface/src/g1_dex3_system.cpp"
click node_policy "https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_controllers/src/g1_agile_controller.cpp"
click node_safety "https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_controllers/src/g1_safety_controller.cpp"
click node_vla "https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_vla/src/vla_server/chunks.cpp"
click node_mock "https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_vla/src/mock_engine_node.cpp"

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_bt,node_skills,node_manip toneBlue
class node_sensors,node_perception_nodes,node_vision_api,node_segmentation,node_world toneAmber
class node_approach,node_nav,node_odom,node_moveit toneMint
class node_hardware,node_hands,node_policy,node_safety toneRose
class node_vla,node_mock,node_operator,node_canopy toneIndigo
```

## Components

### Mission skills

- [Behavior trees](https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_orchestration/src): `workspace/src/g1_orchestration/src`
- [Mission skills](https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_orchestration/src/skills): `workspace/src/g1_orchestration/src/skills`
- [Pick and place](https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_manipulation/src/manipulation_server): `workspace/src/g1_manipulation/src/manipulation_server`

### Perception and maps

- [Sensor relay](https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_sensor_relay/src): `workspace/src/g1_sensor_relay/src`
- [Object perception](https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_perception/src): `workspace/src/g1_perception/src`
- [Vision service](https://github.com/adyansh04/grove-g1/blob/main/servers/vision/server.py): `servers/vision/server.py`
- [Text segmentation](https://github.com/adyansh04/grove-g1/blob/main/servers/vision/segmentation.py): `servers/vision/segmentation.py`
- [World model](https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_orchestration/src/skills/world_model_leaves.cpp): `workspace/src/g1_orchestration/src/skills/world_model_leaves.cpp`

### Navigation and motion

- [Object approach](https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_locomotion/src/base_approach): `workspace/src/g1_locomotion/src/base_approach`
- [Nav2 and SLAM](https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_navigation/launch): `workspace/src/g1_navigation/launch`
- [FAST-LIO odometry](https://github.com/adyansh04/grove-g1/tree/main/workspace/src/g1_state_estimation/src): `workspace/src/g1_state_estimation/src`
- [MoveIt planning](https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_moveit_config/launch/move_group.launch.py): `workspace/src/g1_moveit_config/launch/move_group.launch.py`

### Robot control

- [Body hardware](https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_hardware_interface/src/g1_lowcmd_system.cpp): `workspace/src/g1_hardware_interface/src/g1_lowcmd_system.cpp`
- [Dex3 hand interface](https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_hand_interface/src/g1_dex3_system.cpp): `workspace/src/g1_hand_interface/src/g1_dex3_system.cpp`
- [Locomotion controller](https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_controllers/src/g1_agile_controller.cpp): `workspace/src/g1_controllers/src/g1_agile_controller.cpp`
- [Safety controller](https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_controllers/src/g1_safety_controller.cpp): `workspace/src/g1_controllers/src/g1_safety_controller.cpp`

### Learned policies

- [VLA action chunks](https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_vla/src/vla_server/chunks.cpp): `workspace/src/g1_vla/src/vla_server/chunks.cpp`
- [Mock policy engine](https://github.com/adyansh04/grove-g1/blob/main/workspace/src/g1_vla/src/mock_engine_node.cpp): `workspace/src/g1_vla/src/mock_engine_node.cpp`

### Other components

- **Mission operator**
- **Canopy service**

## Connections

- Mission operator → Behavior trees: starts mission (evidence: `README.md`)
- Behavior trees → Mission skills: ticks skills
- Mission skills → Nav2 and SLAM: requests navigation (evidence: `README.md`)
- Mission skills → Object approach: requests approach (evidence: `README.md`)
- Mission skills → Pick and place: requests pick/place (evidence: `README.md`)
- Pick and place → MoveIt planning: plans motion (evidence: `README.md`)
- Sensor relay → FAST-LIO odometry: supplies LiDAR (evidence: `README.md`)
- FAST-LIO odometry → Nav2 and SLAM: provides odometry (evidence: `README.md`)
- Sensor relay → Object perception: supplies camera data
- Object perception → Vision service: requests segmentation (evidence: `README.md`)
- Vision service → Text segmentation: dispatches requests (evidence: `servers/vision_server.py`)
- Text segmentation → Vision service: returns instances (evidence: `servers/vision/server.py`)
- Object perception → Pick and place: provides object poses (evidence: `README.md`)
- Canopy service → World model: serves world model (evidence: `README.md`)
- Mission skills → World model: queries world model
- Locomotion controller → Safety controller: feeds joint targets
- Safety controller → Body hardware: writes commands
- MoveIt planning → Dex3 hand interface: commands hand joints (evidence: `README.md`)
- VLA action chunks → MoveIt planning: checks action chunks (evidence: `README.md`)
- Mock policy engine → VLA action chunks: serves action chunks (evidence: `workspace/src/g1_vla/src/mock_engine_node.cpp`)
