# iwattsx/isaaclab architecture

> Architecture diagram of the GitHub repository iwattsx/isaaclab, 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/iwattsx/isaaclab
- Repository: https://github.com/iwattsx/isaaclab

## Overview

Isaac Lab is a modular robotics-learning framework built on Isaac Sim. A user selects a task and workflow; an environment coordinates simulation and robot interaction, and an RL workflow trains or evaluates a policy against environment observations and actions. The manager-based RL path is shown in more detail, alongside direct environments, task definitions, and robot assets. The excerpts establish several environment-to-manager relationships; broader simulation and learning integrations are documented at the README level. Unsampled subsystems are represented only where the tree or README supports them.

Main entry points: [`source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env.py`](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env.py) (Manager environment), [`source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_rl_env.py`](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_rl_env.py) (RL environment), [`source/extensions/omni.isaac.lab_tasks/omni/isaac/lab_tasks`](https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab_tasks/omni/isaac/lab_tasks) (Robot tasks), [`source/extensions/omni.isaac.lab/omni/isaac/lab/managers/action_manager.py`](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/managers/action_manager.py) (Action manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User workflows"]
  node_training["RL workflows"]
  node_demonstrations["Demonstration workflows"]
end

subgraph group_tasks["Tasks and assets"]
  node_task_catalog["Robot tasks<br/>[lab_tasks]"]
  node_robot_assets["Robot assets<br/>[lab_assets]"]
end

subgraph group_environment["Environment runtime"]
  node_manager_env["Manager environment"]
  node_rl_env["RL environment"]
  node_direct_env["Direct RL environment<br/>[direct_rl_env.py]"]
  node_env_config["Environment configuration"]
  node_action_manager["Action manager<br/>[action_manager.py]"]
  node_command_manager["Command manager<br/>[command_manager.py]"]
  node_observation_manager["Observation manager"]
  node_event_manager["Event manager<br/>[event_manager.py]"]
  node_manager_base["Manager terms<br/>[manager_base.py]"]
  node_mdp["MDP functions<br/>[mdp]"]
end

subgraph group_runtime["Simulation runtime"]
  node_scene["Interactive scene"]
  node_simulation["Simulation context"]
  node_sensors["Robot sensors<br/>[sensors]"]
end

subgraph group_support["Control and input"]
  node_controllers["Robot controllers<br/>[controllers]"]
  node_actuators["Actuators<br/>[actuators]"]
  node_devices["Teleoperation devices<br/>[devices]"]
end

node_researcher(("Researcher"))
node_isaac_sim["NVIDIA Isaac Sim"]
node_rl_libraries["RL libraries"]

node_researcher -->|"chooses workflow"| node_training
node_researcher -->|"collects data"| node_demonstrations
node_training -.->|"selects task"| node_task_catalog
node_training -->|"trains policy"| node_rl_env
node_demonstrations -.->|"uses task"| node_task_catalog
node_task_catalog -.->|"defines environments"| node_manager_env
node_task_catalog -.->|"defines environments"| node_direct_env
node_task_catalog -.->|"configures robots"| node_robot_assets
node_rl_env -->|"extends"| node_manager_env
node_env_config -->|"configures"| node_manager_env
node_manager_env -->|"initializes"| node_action_manager
node_manager_env -->|"initializes"| node_observation_manager
node_manager_env -->|"initializes"| node_event_manager
node_rl_env -->|"coordinates"| node_command_manager
node_rl_env -->|"processes actions"| node_action_manager
node_action_manager -->|"uses base"| node_manager_base
node_command_manager -->|"uses base"| node_manager_base
node_observation_manager -->|"uses base"| node_manager_base
node_manager_env -.->|"sets up scene"| node_scene
node_manager_env -.->|"controls simulation"| node_simulation
node_scene -.->|"hosts sensors"| node_sensors
node_simulation -->|"runs on"| node_isaac_sim
node_manager_env -->|"configures terms"| node_mdp
node_rl_env -.->|"supports learning"| node_rl_libraries
node_action_manager -.->|"dispatches control"| node_actuators
node_controllers -.->|"computes commands"| node_actuators
node_devices -.->|"provides input"| node_controllers

click node_training "https://github.com/iwattsx/isaaclab/tree/main/source/standalone/workflows"
click node_demonstrations "https://github.com/iwattsx/isaaclab/tree/main/source/standalone/workflows/robomimic"
click node_task_catalog "https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab_tasks/omni/isaac/lab_tasks"
click node_robot_assets "https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab_assets/omni/isaac/lab_assets"
click node_manager_env "https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env.py"
click node_rl_env "https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_rl_env.py"
click node_direct_env "https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/direct_rl_env.py"
click node_env_config "https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env_cfg.py"
click node_action_manager "https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/managers/action_manager.py"
click node_command_manager "https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/managers/command_manager.py"
click node_observation_manager "https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/managers/observation_manager.py"
click node_event_manager "https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/managers/event_manager.py"
click node_manager_base "https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/managers/manager_base.py"
click node_mdp "https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/mdp"
click node_scene "https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/scene/interactive_scene.py"
click node_simulation "https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/sim/simulation_context.py"
click node_sensors "https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab/omni/isaac/lab/sensors"
click node_controllers "https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab/omni/isaac/lab/controllers"
click node_actuators "https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab/omni/isaac/lab/actuators"
click node_devices "https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab/omni/isaac/lab/devices"

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_training,node_demonstrations toneBlue
class node_task_catalog,node_robot_assets toneAmber
class node_manager_env,node_rl_env,node_direct_env,node_env_config,node_action_manager,node_command_manager,node_observation_manager,node_event_manager,node_manager_base,node_mdp toneMint
class node_scene,node_simulation,node_sensors toneRose
class node_controllers,node_actuators,node_devices,node_researcher,node_isaac_sim,node_rl_libraries toneIndigo
```

## Components

### User workflows

- [RL workflows](https://github.com/iwattsx/isaaclab/tree/main/source/standalone/workflows): `source/standalone/workflows`
- [Demonstration workflows](https://github.com/iwattsx/isaaclab/tree/main/source/standalone/workflows/robomimic): `source/standalone/workflows/robomimic`

### Tasks and assets

- [Robot tasks](https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab_tasks/omni/isaac/lab_tasks): `source/extensions/omni.isaac.lab_tasks/omni/isaac/lab_tasks`
- [Robot assets](https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab_assets/omni/isaac/lab_assets): `source/extensions/omni.isaac.lab_assets/omni/isaac/lab_assets`

### Environment runtime

- [Manager environment](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env.py): `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env.py`
- [RL environment](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_rl_env.py): `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_rl_env.py`
- [Direct RL environment](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/direct_rl_env.py): `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/direct_rl_env.py`
- [Environment configuration](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env_cfg.py): `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env_cfg.py`
- [Action manager](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/managers/action_manager.py): `source/extensions/omni.isaac.lab/omni/isaac/lab/managers/action_manager.py`
- [Command manager](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/managers/command_manager.py): `source/extensions/omni.isaac.lab/omni/isaac/lab/managers/command_manager.py`
- [Observation manager](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/managers/observation_manager.py): `source/extensions/omni.isaac.lab/omni/isaac/lab/managers/observation_manager.py`
- [Event manager](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/managers/event_manager.py): `source/extensions/omni.isaac.lab/omni/isaac/lab/managers/event_manager.py`
- [Manager terms](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/managers/manager_base.py): `source/extensions/omni.isaac.lab/omni/isaac/lab/managers/manager_base.py`
- [MDP functions](https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab/omni/isaac/lab/envs/mdp): `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/mdp`

### Simulation runtime

- [Interactive scene](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/scene/interactive_scene.py): `source/extensions/omni.isaac.lab/omni/isaac/lab/scene/interactive_scene.py`
- [Simulation context](https://github.com/iwattsx/isaaclab/blob/main/source/extensions/omni.isaac.lab/omni/isaac/lab/sim/simulation_context.py): `source/extensions/omni.isaac.lab/omni/isaac/lab/sim/simulation_context.py`
- [Robot sensors](https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab/omni/isaac/lab/sensors): `source/extensions/omni.isaac.lab/omni/isaac/lab/sensors`

### Control and input

- [Robot controllers](https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab/omni/isaac/lab/controllers): `source/extensions/omni.isaac.lab/omni/isaac/lab/controllers`
- [Actuators](https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab/omni/isaac/lab/actuators): `source/extensions/omni.isaac.lab/omni/isaac/lab/actuators`
- [Teleoperation devices](https://github.com/iwattsx/isaaclab/tree/main/source/extensions/omni.isaac.lab/omni/isaac/lab/devices): `source/extensions/omni.isaac.lab/omni/isaac/lab/devices`

### Other components

- **Researcher**
- **NVIDIA Isaac Sim**
- **RL libraries**

## Connections

- Researcher → RL workflows: chooses workflow (evidence: `README.md`)
- Researcher → Demonstration workflows: collects data (evidence: `README.md`)
- RL workflows → Robot tasks: selects task (evidence: `source/standalone/workflows/robomimic/train.py`)
- RL workflows → RL environment: trains policy (evidence: `source/standalone/workflows/rl_games/train.py`)
- Demonstration workflows → Robot tasks: uses task (evidence: `source/standalone/workflows/robomimic/train.py`)
- Robot tasks → Manager environment: defines environments
- Robot tasks → Direct RL environment: defines environments
- Robot tasks → Robot assets: configures robots
- RL environment → Manager environment: extends (evidence: `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_rl_env.py`)
- Environment configuration → Manager environment: configures (evidence: `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env_cfg.py`)
- Manager environment → Action manager: initializes (evidence: `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env.py`)
- Manager environment → Observation manager: initializes (evidence: `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env.py`)
- Manager environment → Event manager: initializes (evidence: `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_env.py`)
- RL environment → Command manager: coordinates (evidence: `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_rl_env.py`)
- RL environment → Action manager: processes actions (evidence: `source/extensions/omni.isaac.lab/omni/isaac/lab/envs/manager_based_rl_env.py`)
- Action manager → Manager terms: uses base (evidence: `source/extensions/omni.isaac.lab/omni/isaac/lab/managers/action_manager.py`)
- Command manager → Manager terms: uses base (evidence: `source/extensions/omni.isaac.lab/omni/isaac/lab/managers/command_manager.py`)
- Observation manager → Manager terms: uses base (evidence: `source/extensions/omni.isaac.lab/omni/isaac/lab/managers/observation_manager.py`)
- Manager environment → Interactive scene: sets up scene
- Manager environment → Simulation context: controls simulation
- Interactive scene → Robot sensors: hosts sensors
- Simulation context → NVIDIA Isaac Sim: runs on (evidence: `README.md`)
- Manager environment → MDP functions: configures terms
- RL environment → RL libraries: supports learning (evidence: `README.md`)
- Action manager → Actuators: dispatches control
- Robot controllers → Actuators: computes commands
- Teleoperation devices → Robot controllers: provides input
