首页 / Robot / G1 E2E / Isaac Lab-Arena 安装

Isaac Lab-Arena 安装

中文译本 · 原文 Isaac Lab-Arena 安装

安装 Isaac Lab-Arena,并校验本仿真工作流使用的 Unitree G1 静态「苹果→盘子」环境。

本课会做这几件事:

安装 Isaac Lab-Arena

Isaac Lab-Arena 跑在 Isaac Sim 6.0.0 和 Isaac Lab 3.0.0 上。Docker 构建会自动装上这些依赖。

  1. 把 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 容器里从源码安装。

  1. 进入克隆下来的仓库。
cd IsaacLab-Arena
  1. 启动容器前,在宿主机上建好数据集、模型和评测输出目录。

默认情况下,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
  1. 启动基础 Isaac Lab-Arena 容器。
./docker/run_docker.sh

本仿真工作流的后训练和评测使用另一份独立的 Isaac-GR00T 检出,所以走默认的基础容器。容器里有 -g 可以把 GR00T 依赖装进去,这里不用。

  1. 可选:在容器里验证安装。

完整验证大约要 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/
  1. 在容器里创建数据和模型目录,并设环境变量,后面的命令会短一些。
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)并打开相机。这是确认场景、任务和终止逻辑接好的最快办法,不需要遥操作硬件。

(可选)跑自动测试

  1. 在 Isaac Lab-Arena 容器里跑环境测试,合计大约 2 分钟。
python -m pytest isaaclab_arena/tests/test_g1_static_pick_and_place.py -v
  1. 确认两个测试都通过。终端示例:
=========== 2 passed, 3488 warnings in 95.54s (0:01:35) ===========
注意

如果第一次执行时苹果穿过架子掉下去,把命令再跑一遍即可。

原因:Objaverse 苹果 USD 从 S3 流式下载,PhysX 会按内置的 0.01 倍缩放重新烘焙碰撞网格。第一次执行时,碰撞体可能比第一步物理晚一帧出现,苹果会穿出架子表面。之后从 /tmp/Assets/ 读缓存,生成就正常了。

在容器外安装 Isaac GR00T

  1. 另开一个终端。
  2. 在容器外设置克隆位置。可以改路径,后面会复用这个变量。
export ISAAC_GR00T_DIR=$HOME/Isaac-GR00T
  1. 克隆 Isaac-GR00T,并切到本工作流验证过的提交。
git clone https://github.com/NVIDIA/Isaac-GR00T.git $ISAAC_GR00T_DIR
cd $ISAAC_GR00T_DIR
git checkout 4b1dca9d88d2a0b9ea5a65aa61c82ff89f5c4f0e
  1. 用 uv 建一个新的虚拟环境。它和 Arena 容器是分开的。
uv sync

微调和策略服务器都从这个独立检出启动。这样可以升级到更新的 GR00T 版本,而不必重建 Arena 的 GR00T 容器,也不用改 submodules/Isaac-GR00T。

要点

我们已经装好 Isaac Lab-Arena、准备了共享数据与模型目录、配置了独立的 Isaac-GR00T,并确认静态苹果任务能正确加载。下一步走读环境代码,再采集遥操作数据。