# Unitree Sim IsaacLab
**Source:** https://github.com/unitreerobotics/unitree_sim_isaaclab
**Fetched:** 2026-02-13
**Type:** GitHub Repository README

---

# Unitree Sim IsaacLab: Robot Simulation Framework

## Project Overview

This repository provides a comprehensive simulation environment for Unitree robots built on Isaac Lab and Isaac Sim. The project enables "data collection, playback, generation, and model validation" while maintaining compatibility with real robot DDS communication protocols.

## Supported Robots & Tasks

The framework supports multiple Unitree robot configurations:
- **G1 (29-DOF)**: With gripper, Dex3 hand, or Inspire hand variants
- **H1-2 (27-DOF)**: With Inspire hand

Available task scenarios include pick-and-place operations with cylindrical and cubic objects, stacking tasks, and mobile manipulation exercises (marked "Wholebody" for locomotion-enabled variants).

## Technical Requirements

**Software Stack:**
- Isaac Sim 4.5.0 or 5.0.0
- Isaac Lab framework
- Ubuntu 20.04 or 22.04+
- Python-based development environment

**Hardware:**
- Tested on RTX 3080, 3090, and 4090 GPUs
- RTX 50-series requires Isaac Sim 5.0.0

## Key Architecture Components

The codebase organizes into several functional modules:

- **DDS Communication**: Implements distributed data service messaging matching real robot protocols
- **Action Providers**: Supports teleoperation commands, file-based playback, and policy-generated actions
- **Task Framework**: Modular scene construction with common configurations, observations, and termination conditions
- **Image Server**: ZMQ-based visual data publishing

## Usage Modes

Users can run the simulator for:
1. **Teleoperation**: Real-time control via DDS interfaces
2. **Data Replay**: Playback recorded trajectories from the xr_teleoperate project
3. **Data Generation**: Augment datasets through environmental variations (lighting, camera parameters)

## Important Caveats

The documentation emphasizes that "weight files provided in this project are only for simulation environment testing" and warns users to distinguish simulated systems from physical robots on the same network to avoid conflicts.