训练框架开源

Unitree RL GYM

宇树科技中国

GitHub 仓库 unitreerobotics/unitree_rl_gym

又称 unitree_rl_gym

类别
框架与工具 · 训练框架
开放程度
开源
发布时间
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。版本更新后命令可能变化,以官方文档为准。

  1. 创建 conda 环境

    conda create -n unitree-rl python=3.8
    conda activate unitree-rl
  2. 安装 PyTorch

    conda install pytorch==2.3.1 torchvision==0.18.1 torchaudio==2.3.1 pytorch-cuda=12.1 -c pytorch -c nvidia
  3. 安装 Isaac Gym

    先从 NVIDIA 官网下载并解压

    cd isaacgym/python
    pip install -e .
  4. 安装 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 .
  5. 安装 unitree_rl_gym

    上真机还要装 unitree_sdk2_python

    git clone https://github.com/unitreerobotics/unitree_rl_gym.git
    cd unitree_rl_gym
    pip install -e .
  6. 开始训练来源: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

适配矩阵

来源: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 . 把项目装进当前环境

pip install -e .
来源:Issue #3
RuntimeError: nvrtc: error: invalid value for --gpu-architecture (-arch)

原因提问者(RTX 4060 笔记本)最后定位到 g++ 版本过低

解决提问者先按 NVIDIA 论坛帖升级 PyTorch,ninja 再失败时升级 g++ 后解决

来源:Issue #23
RuntimeError: 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 #41
isTuple()INTERNAL ASSERT FAILED

原因Sim2Sim 直接加载了训练 checkpoint,不是导出的模型

解决先用 play 跑一遍这个 checkpoint,把 exported 目录里生成的 .pt 填进配置的 policy_path

python legged_gym/scripts/play.py --task=xxx
来源:Issue #21

适配机器人

  • Unitree Go2
  • Unitree H1
  • Unitree H1_2
  • Unitree G1

获取方式

发布方

数据来源

本页信息均整理自以下公开资料。

9 条来源核验于 2026-10-01

星标、下载量等指标定期自动更新。

Unitree RL GYM(unitree_rl_gym):安装步骤、环境要求与常见报错 | 具身集