Isaac Lab-Arena 安装
中文译本 · 原文 Isaac Lab-Arena 安装
安装 Isaac Lab-Arena,并校验本仿真工作流使用的 Unitree G1 静态「苹果→盘子」环境。
本课会做这几件事:
- 从源码安装 Isaac Lab-Arena,并初始化所需子模块。
- 为仿真工作流准备共享的数据与模型目录。
- 跑自动测试,确认场景、任务和终止逻辑。
- 配置一份独立的 Isaac-GR00T 检出,供后训练和评测使用。
安装 Isaac Lab-Arena
Isaac Lab-Arena 跑在 Isaac Sim 6.0.0 和 Isaac Lab 3.0.0 上。Docker 构建会自动装上这些依赖。
- 把 Isaac Lab-Arena 克隆到 release 分支,并初始化子模块。
教程假设克隆到 ~/IsaacLab-Arena,你也可以放到别处。
cd ~/ git clone --branch release/0.2.1 --recurse-submodules git@github.com:isaac-sim/IsaacLab-Arena.git
必须递归初始化子模块,因为 Arena 依赖固定版本的外部仓库,包括 Isaac Lab。
Isaac Lab-Arena 在自己的 Docker 容器里从源码安装。
- 进入克隆下来的仓库。
cd IsaacLab-Arena
- 启动容器前,在宿主机上建好数据集、模型和评测输出目录。
默认情况下,Docker 启动脚本会在这些宿主机目录存在时,把 $HOME/datasets 挂到 /datasets,$HOME/models 挂到 /models,$HOME/eval 挂到 /eval。
如果要换目录,跳过这一步,启动容器时用 -d、-m、-e 分别指定数据集、模型和评测目录。
mkdir -p $HOME/datasets mkdir -p $HOME/models mkdir -p $HOME/eval
- 启动基础 Isaac Lab-Arena 容器。
./docker/run_docker.sh
本仿真工作流的后训练和评测使用另一份独立的 Isaac-GR00T 检出,所以走默认的基础容器。容器里有 -g 可以把 GR00T 依赖装进去,这里不用。
- 可选:在容器里验证安装。
完整验证大约要 20–30 分钟(性能较好的工作站)。后面还会跑一个针对静态苹果任务的测试,直接校验课程环境。
pytest -sv -m "with_cameras and not with_subprocess" isaaclab_arena/tests/ pytest -sv -m "not with_cameras and not with_subprocess" isaaclab_arena/tests/ pytest -sv -m with_subprocess isaaclab_arena/tests/
- 在容器里创建数据和模型目录,并设环境变量,后面的命令会短一些。
export DATASET_DIR=/datasets/isaaclab_arena/static_apple_tutorial mkdir -p $DATASET_DIR export MODELS_DIR=/models/isaaclab_arena/static_apple_tutorial mkdir -p $MODELS_DIR
用自动测试校验环境
有一个专门的 pytest 模块覆盖静态苹果任务,断言两件事:
- 苹果还在初始位姿时,任务不会终止。
- 把苹果传送到盘子上方并让它落稳后,成功终止会触发。
测试无界面(headless)并打开相机。这是确认场景、任务和终止逻辑接好的最快办法,不需要遥操作硬件。
(可选)跑自动测试
- 在 Isaac Lab-Arena 容器里跑环境测试,合计大约 2 分钟。
python -m pytest isaaclab_arena/tests/test_g1_static_pick_and_place.py -v
- 确认两个测试都通过。终端示例:
=========== 2 passed, 3488 warnings in 95.54s (0:01:35) ===========
如果第一次执行时苹果穿过架子掉下去,把命令再跑一遍即可。
原因:Objaverse 苹果 USD 从 S3 流式下载,PhysX 会按内置的 0.01 倍缩放重新烘焙碰撞网格。第一次执行时,碰撞体可能比第一步物理晚一帧出现,苹果会穿出架子表面。之后从 /tmp/Assets/ 读缓存,生成就正常了。
在容器外安装 Isaac GR00T
- 另开一个终端。
- 在容器外设置克隆位置。可以改路径,后面会复用这个变量。
export ISAAC_GR00T_DIR=$HOME/Isaac-GR00T
- 克隆 Isaac-GR00T,并切到本工作流验证过的提交。
git clone https://github.com/NVIDIA/Isaac-GR00T.git $ISAAC_GR00T_DIR cd $ISAAC_GR00T_DIR git checkout 4b1dca9d88d2a0b9ea5a65aa61c82ff89f5c4f0e
- 用 uv 建一个新的虚拟环境。它和 Arena 容器是分开的。
uv sync
微调和策略服务器都从这个独立检出启动。这样可以升级到更新的 GR00T 版本,而不必重建 Arena 的 GR00T 容器,也不用改 submodules/Isaac-GR00T。
要点
我们已经装好 Isaac Lab-Arena、准备了共享数据与模型目录、配置了独立的 Isaac-GR00T,并确认静态苹果任务能正确加载。下一步走读环境代码,再采集遥操作数据。