训练框架开源

legged_gym

ETH Zurich、NVIDIA瑞士

GitHub 仓库 leggedrobotics/legged_gym

又称 Isaac Gym Environments for Legged Robots

类别
框架与工具 · 训练框架
开放程度
开源
发布时间
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,本仓库之后只有有限的更新和支持,并鼓励用户迁移。

  1. 创建 Python 虚拟环境

    Python 3.6 到 3.8,官方推荐 3.8

  2. 安装 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
  3. 安装 Isaac Gym

    先从 NVIDIA 官网下载 Preview 3

    cd isaacgym/python && pip install -e .
    cd examples && python 1080_balls_of_solitude.py
  4. 安装 rsl_rl

    先克隆 leggedrobotics/rsl_rl

    cd rsl_rl && git checkout v1.0.2 && pip install -e .
  5. 安装 legged_gym

    先克隆本仓库

    cd legged_gym && pip install -e .
  6. 开始训练

    无界面加 --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__.py

envs/__init__.py 里注册的任务,用 --task 指定

名称--task 任务名Isaac Gym 训练
ANYmal C(粗糙地形)anymal_c_rough✓
ANYmal C(平地)anymal_c_flat✓
ANYmal Banymal_b✓
Unitree A1a1✓
Cassiecassie✓

✓ 官方资料写明支持,— 资料没写,版本号照原文。没写不等于不支持。

常见报错

解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。

ImportError: libpython3.8m.so.1.0: cannot open shared object file: No such file or directory

解决安装 libpython3.8;conda 用户还可能要把环境的 lib 目录加进 LD_LIBRARY_PATH

sudo apt install libpython3.8
export LD_LIBRARY_PATH=/path/to/conda/envs/your_env/lib
来源:README.md
ValueError: too many values to unpack (expected 2)

原因rsl_rl 版本太新

解决切到 rsl_rl v1.0.2;已经是这个版本还报错时,确认旧的 v2.0.2 已经卸干净

cd rsl_rl && git checkout v1.0.2 && pip install -e .
来源:Issue #59
RuntimeError: nvrtc: error: invalid value for --gpu-architecture (-arch)

原因PyTorch 和 CUDA 不兼容

解决卸载后重装匹配本机 CUDA 的 PyTorch,下面是提问者 CUDA 12.3 时用的命令

pip3 uninstall torch torchvision torchaudio
pip3 install torch torchvision torchaudio -f https://download.pytorch.org/whl/cu123/torch_stable.html
来源:Issue #57
*** Warning: failed to preload PhysX libs

原因提问者在 Windows 上运行,Isaac Gym 只支持 Ubuntu 18.04 和 20.04

解决换到 Ubuntu 18.04 或 20.04 上安装

来源:Issue #21
RuntimeError: 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

获取方式

数据来源

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

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

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

legged_gym:安装步骤、环境要求与常见报错 | 具身集