- 类别
- 框架与工具 · 训练框架
- 开放程度
- 开源
- 发布时间
- 2023 年 10 月
- 开源协议
- BSD-3-Clause
- 发布方所在地
- 中国
项目简介
宇树科技官方的强化学习运动控制示例仓库,基于 legged_gym 与 rsl_rl,在 Isaac Gym 中训练宇树机器人的行走策略,覆盖训练、回放、Sim2Sim(MuJoCo)到 Sim2Real 的完整流程。支持 Go2、G1、H1、H1_2,导出的策略可通过 unitree_sdk2_python 部署到真机,仓库内附 G1 等机型的预训练策略和 C++ 部署示例。
Unitree RL GYM 安装要点
来源:setup_en.md依据官方资料的 main 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
创建 conda 环境
conda create -n unitree-rl python=3.8 conda activate unitree-rl安装 PyTorch
conda install pytorch==2.3.1 torchvision==0.18.1 torchaudio==2.3.1 pytorch-cuda=12.1 -c pytorch -c nvidia安装 Isaac Gym
先从 NVIDIA 官网下载并解压
cd isaacgym/python pip install -e .安装 rsl_rl
必须切到 v1.0.2
git clone https://github.com/leggedrobotics/rsl_rl.git cd rsl_rl git checkout v1.0.2 pip install -e .安装 unitree_rl_gym
上真机还要装 unitree_sdk2_python
git clone https://github.com/unitreerobotics/unitree_rl_gym.git cd unitree_rl_gym pip install -e .开始训练来源:README.md
task 可选 go2、g1、h1、h1_2
python legged_gym/scripts/train.py --task=xxx
环境要求
来源:setup_en.md- 操作系统
- Ubuntu 18.04 或更高(官方推荐)
- GPU
- NVIDIA 显卡
- 显卡驱动
- 525 或更高(官方推荐)
- Python
- 3.8
- PyTorch
- 2.3.1,CUDA 12.1
- Isaac Gym
- 从 NVIDIA 官网下载
- rsl_rl
- v1.0.2
- MuJoCo来源:setup.py
- 3.2.3
适配矩阵
来源:README.md机器人在训练、Sim2Sim 和真机部署各阶段的支持情况,空格表示官方未明确说明
| 名称 | Isaac Gym 训练 | MuJoCo Sim2Sim | 真机(Python) | 真机(C++) |
|---|---|---|---|---|
| Go2deploy 的 mujoco 和真机配置目录里没有 go2.yaml | ✓ | — | — | — |
| G1默认配置是 12 自由度(g1_12dof.urdf) | ✓ | ✓ | ✓ | ✓ |
| H1来源:README.md | ✓ | ✓ | ✓ | — |
| H1_2来源:README.md | ✓ | ✓ | ✓ | — |
✓ 官方资料写明支持,— 资料没写。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
ModuleNotFoundError: No module named "legged_gym"解决在 unitree_rl_gym 目录执行 pip install -e . 把项目装进当前环境
来源:Issue #3pip install -e .RuntimeError: nvrtc: error: invalid value for --gpu-architecture (-arch)原因提问者(RTX 4060 笔记本)最后定位到 g++ 版本过低
解决提问者先按 NVIDIA 论坛帖升级 PyTorch,ninja 再失败时升级 g++ 后解决
来源:Issue #23RuntimeError: shape '[-1, 1044, 64]' is invalid for input of size 1572864原因rsl_rl 的 unpad_trajectories 维度不匹配
解决先确认 rsl_rl 没被改动、和 v1.0.2 一致;训练到一千次左右才报时,按 rsl_rl PR #12 在 utils.py 加两行
来源:Issue #41isTuple()INTERNAL ASSERT FAILED原因Sim2Sim 直接加载了训练 checkpoint,不是导出的模型
解决先用 play 跑一遍这个 checkpoint,把 exported 目录里生成的 .pt 填进配置的 policy_path
来源:Issue #21python legged_gym/scripts/play.py --task=xxx
适配机器人
- Unitree Go2
- Unitree H1
- Unitree H1_2
- Unitree G1
