- 类别
- 框架与工具 · 训练框架
- 开放程度
- 开源
- 发布时间
- 2021 年 9 月
- 开源协议
- BSD-3-Clause
- 发布方所在地
- 瑞士
项目简介
ETH Zurich 机器人系统实验室基于 Isaac Gym 开发的足式机器人强化学习环境,用 GPU 大规模并行仿真训练崎岖地形行走,配套 rsl_rl 的 PPO 实现。包含执行器网络、摩擦与质量随机化、观测噪声、随机推挤等 sim-to-real 组件,内置 ANYmal B / C、A1、Cassie 配置。宇树等厂商的训练代码由它改写;环境已迁到 Isaac Lab,本仓库有限维护。
legged_gym 安装要点
来源:README.md依据官方资料的 master 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
官方已把环境迁移到 Isaac Lab,本仓库之后只有有限的更新和支持,并鼓励用户迁移。
创建 Python 虚拟环境
Python 3.6 到 3.8,官方推荐 3.8
安装 PyTorch
pip3 install torch==1.10.0+cu113 torchvision==0.11.1+cu113 torchaudio==0.10.0+cu113 -f https://download.pytorch.org/whl/cu113/torch_stable.html安装 Isaac Gym
先从 NVIDIA 官网下载 Preview 3
cd isaacgym/python && pip install -e . cd examples && python 1080_balls_of_solitude.py安装 rsl_rl
先克隆 leggedrobotics/rsl_rl
cd rsl_rl && git checkout v1.0.2 && pip install -e .安装 legged_gym
先克隆本仓库
cd legged_gym && pip install -e .开始训练
无界面加 --headless;训练开始后按 v 可关渲染提速
python legged_gym/scripts/train.py --task=anymal_c_flat
环境要求
来源:README.md- Python
- 3.6、3.7 或 3.8(官方推荐 3.8)
- PyTorch
- 1.10,CUDA 11.3
- Isaac Gym
- Preview 3,Preview 2 不能用
- rsl_rl
- v1.0.2
适配矩阵
来源:__init__.pyenvs/__init__.py 里注册的任务,用 --task 指定
| 名称 | --task 任务名 | Isaac Gym 训练 |
|---|---|---|
| ANYmal C(粗糙地形) | anymal_c_rough | ✓ |
| ANYmal C(平地) | anymal_c_flat | ✓ |
| ANYmal B | anymal_b | ✓ |
| Unitree A1 | a1 | ✓ |
| Cassie | cassie | ✓ |
✓ 官方资料写明支持,— 资料没写,版本号照原文。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
ImportError: libpython3.8m.so.1.0: cannot open shared object file: No such file or directory解决安装 libpython3.8;conda 用户还可能要把环境的 lib 目录加进 LD_LIBRARY_PATH
来源:README.mdsudo apt install libpython3.8 export LD_LIBRARY_PATH=/path/to/conda/envs/your_env/libValueError: too many values to unpack (expected 2)原因rsl_rl 版本太新
解决切到 rsl_rl v1.0.2;已经是这个版本还报错时,确认旧的 v2.0.2 已经卸干净
来源:Issue #59cd rsl_rl && git checkout v1.0.2 && pip install -e .RuntimeError: nvrtc: error: invalid value for --gpu-architecture (-arch)原因PyTorch 和 CUDA 不兼容
解决卸载后重装匹配本机 CUDA 的 PyTorch,下面是提问者 CUDA 12.3 时用的命令
来源:Issue #57pip3 uninstall torch torchvision torchaudio pip3 install torch torchvision torchaudio -f https://download.pytorch.org/whl/cu123/torch_stable.html*** Warning: failed to preload PhysX libs原因提问者在 Windows 上运行,Isaac Gym 只支持 Ubuntu 18.04 和 20.04
解决换到 Ubuntu 18.04 或 20.04 上安装
来源:Issue #21RuntimeError: CUDA error: an illegal memory access was encountered解决提问者换了更好的显卡后解决;另有用户把环境数从 8192 降到 4096 后不再报错
来源:Issue #77[Error] [carb.gym.plugin] Failed to parse URDF file原因项目的 URDF 有一个标签只有 Isaac Gym Preview 3 支持
解决确认装的是 Isaac Gym Preview 3,不是 Preview 2
来源:Issue #18
适配机器人
- ANYmal C
- ANYmal B
- A1
- Cassie