- 类别
- 框架与工具 · 训练框架
- 开放程度
- 开源
- 发布时间
- 2022 年 11 月
- 开源协议
- MIT
- 发布方所在地
- 美国
项目简介
MIT Improbable AI Lab 的宇树 Go1 四足 sim-to-real 运动控制入门套件,对应论文《Walk These Ways》。基于 legged_gym、rsl_rl 与 Isaac Gym,用 PPO、域随机化和行为多样性(MoB)训练可调步态、速度和姿态的单一策略,提供预训练模型,可经 unitree_legged_sdk 部署到 Go1 Edu 真机。
Walk These Ways 安装要点
来源:README.md依据官方资料的 master 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
安装 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 4
tar -xf IsaacGym_Preview_4_Package.tar.gz cd isaacgym/python && pip install -e .验证 Isaac Gym
python examples/1080_balls_of_solitude.py安装 go1_gym
在本仓库根目录执行
pip install -e .验证环境
应该打印 Simulating step {i}
python scripts/test.py开始训练
显存不够就减小 Cfg.env.num_envs,默认 4000
python scripts/train.py
环境要求
来源:README.md- GPU
- NVIDIA 显卡
- 显存
- 官方建议至少 10GB,默认配置训练约占 12GB
- PyTorch
- 1.10,CUDA 11.3
- Isaac Gym
- Preview 4
- numpy来源:setup.py
- 1.23.5
- 真机
- Unitree Go1 Edu
- 部署镜像
- deployment_image.tar,约 3.5GB
适配矩阵
来源:README.md各机型在训练、仿真评估和真机部署阶段的官方支持情况,空格表示未明确说明
| 名称 | Isaac Gym 训练 | 仿真评估 | 真机部署 |
|---|---|---|---|
| Go1 Edu用 unitree_legged_sdk 部署 | ✓ | ✓ | ✓ |
| Go1(非 Edu)真机要 Edu 版 | — | — | 不支持 |
| Go2维护者说要自行修改重编 lcm_position.cpp,社区有移植版来源:Issue #64 | — | — | 不支持 |
| A1维护者听说有人部署成功,但没见到开源代码来源:Issue #82 | — | — | — |
✓ 官方资料写明支持,— 资料没写。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
./lcm_position: 1: Syntax error: word unexpected (expecting ")")原因lcm_position 是给 Jetson 的 ARM aarch64 编译的
解决部署到外部 PC 或 NUC 时,用 Improbable-AI/unitree_legged_sdk 按本机架构重新编译
来源:README.mdOut of disk space解决运行 install_deployment_code.sh 磁盘不够时,把脚本改用 192.168.123.13,或部署到外部 PC
来源:README.md./lcm_position: error while loading shared libraries: liblcm.so.1: cannot open shared object file: No such file or directory原因在 docker 里运行了 start_unitree_sdk.sh
解决退出 docker,在 Jetson Nano 的宿主系统里运行这个脚本
来源:Issue #48./start_unitree_sdk.shImportError: cannot import name 'PrefixProto' from 'params_proto'原因params_proto 版本不对
解决拉取最新代码后重新安装,setup.py 已经锁定版本
来源:Issue #6pip install -e .AttributeError: module 'numpy' has no attribute 'float'原因numpy 版本太新
解决降级 numpy,提问者用 numpy<1.24 解决,当前 setup.py 锁定 1.23.5
来源:Issue #6pip install "numpy<1.24"RuntimeError: nvrtc: error: invalid value for --gpu-architecture (-arch)解决按 README 装 PyTorch 1.10 后运行 test.py 报错时,提问者升级 PyTorch 后解决
来源:Issue #26
适配机器人
- Unitree Go1