- 类别
- 框架与工具 · 训练框架
- 开放程度
- 开源
- 发布时间
- 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。版本更新后命令可能变化,以官方文档为准。
创建 Python 3.8 环境
conda create -n myenv python=3.8安装 NVIDIA 驱动
最低支持 515
sudo apt install nvidia-driver-525安装 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安装 Isaac Gym
先从 NVIDIA 官网下载 Isaac Gym Preview 4
cd isaacgym/python && pip install -e . cd examples && python 1080_balls_of_solitude.py安装 humanoid-gym
先克隆本仓库
cd humanoid-gym && pip install -e .启动训练
在 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.mdREADME 里验证过的机器人和阶段
| 名称 | 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
来源:README.mdexport LD_LIBRARY_PATH="~/miniconda3/envs/your_env/lib:$LD_LIBRARY_PATH" sudo apt install libpython3.8AttributeError: module 'distutils' has no attribute 'version'解决README 给的解法是改装 PyTorch 1.12.0
来源:README.mdconda install pytorch torchvision torchaudio cudatoolkit=11.3 -c pytorchlibstdc++.so.6: version `GLIBCXX_3.4.20` not found原因conda 自带的 libstdc++ 和系统编译 Isaac Gym 用的版本不一致
解决把 conda 环境里的 libstdc++ 移到 _unused 目录
来源:README.mdmkdir ${YOUR_CONDA_ENV}/lib/_unused mv ${YOUR_CONDA_ENV}/lib/libstdc++* ${YOUR_CONDA_ENV}/lib/_unused
适配机器人
- XBot-S
- XBot-L
