训练框架开源

Humanoid-Gym

星动纪元、清华大学中国

GitHub 仓库 roboterax/humanoid-gym

类别
框架与工具 · 训练框架
开放程度
开源
发布时间
2024 年 3 月
开源协议
BSD-3-Clause
发布方所在地
中国

项目简介

星动纪元开源的人形机器人强化学习训练框架,基于 NVIDIA Isaac Gym 训练行走等运动技能,提供针对人形机器人的奖励设计,并集成从 Isaac Gym 到 MuJoCo 的 Sim2Sim 验证流程,目标是零样本迁移到真机。以星动纪元 XBot-L 为主要示例,已在 XBot-S、XBot-L 真机上验证,稍作调整可用于其他人形机器人。

Humanoid-Gym 安装要点

来源:README.md

依据官方资料的 main 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。

  1. 创建 Python 3.8 环境

    conda create -n myenv python=3.8
  2. 安装 NVIDIA 驱动

    最低支持 515

    sudo apt install nvidia-driver-525
  3. 安装 PyTorch 和 NumPy

    conda install pytorch==1.13.1 torchvision==0.14.1 torchaudio==0.13.1 pytorch-cuda=11.7 -c pytorch -c nvidia
    conda install numpy=1.23
  4. 安装 Isaac Gym

    先从 NVIDIA 官网下载 Isaac Gym Preview 4

    cd isaacgym/python && pip install -e .
    cd examples && python 1080_balls_of_solitude.py
  5. 安装 humanoid-gym

    先克隆本仓库

    cd humanoid-gym && pip install -e .
  6. 启动训练

    在 humanoid-gym/humanoid 目录下运行

    python scripts/train.py --task=humanoid_ppo --run_name v1 --headless --num_envs 4096

环境要求

来源:README.md
系统来源:Issue #18
Ubuntu 20.04 或 22.04,WSL2 未测试(作者在 issue #18 的说明)
Python
3.8
NVIDIA 驱动
官方推荐 525,最低 515
PyTorch
1.13.1 + CUDA 11.7
NumPy
1.23
Isaac Gym
Preview 4
MuJoCo来源:setup.py
2.3.6(setup.py 固定)

适配矩阵

来源:README.md

README 里验证过的机器人和阶段

名称Isaac Gym 训练MuJoCo sim2sim真机部署
XBot-LREADME 的主要示例✓✓✓
XBot-S——✓

✓ 官方资料写明支持,— 资料没写。没写不等于不支持。

常见报错

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

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

解决把 conda 环境的 lib 目录加进 LD_LIBRARY_PATH,或安装 libpython3.8

export LD_LIBRARY_PATH="~/miniconda3/envs/your_env/lib:$LD_LIBRARY_PATH"
sudo apt install libpython3.8
来源:README.md
AttributeError: module 'distutils' has no attribute 'version'

解决README 给的解法是改装 PyTorch 1.12.0

conda install pytorch torchvision torchaudio cudatoolkit=11.3 -c pytorch
来源:README.md
libstdc++.so.6: version `GLIBCXX_3.4.20` not found

原因conda 自带的 libstdc++ 和系统编译 Isaac Gym 用的版本不一致

解决把 conda 环境里的 libstdc++ 移到 _unused 目录

mkdir ${YOUR_CONDA_ENV}/lib/_unused
mv ${YOUR_CONDA_ENV}/lib/libstdc++* ${YOUR_CONDA_ENV}/lib/_unused
来源:README.md

适配机器人

  • XBot-S
  • XBot-L

获取方式

发布方

相关概念

数据来源

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

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

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

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