- 类别
- 仿真与评测 · 仿真器
- 开放程度
- 开源
- 发布时间
- 2023 年 1 月
- 开源协议
- BSD-3-Clause(isaaclab_mimic 扩展为 Apache-2.0)
- 发布方所在地
- 美国
项目简介
NVIDIA 基于 Isaac Sim 的 GPU 加速机器人学习框架,前身为 Orbit,用于强化学习、模仿学习和运动规划。内置机械臂、四足、人形等机器人模型和现成训练环境,可对接 RSL RL、SKRL、RL Games、Stable Baselines 等训练库,支持多智能体;提供 RTX 相机、激光雷达、IMU、接触传感器仿真,可本地或云端分布式运行,面向 sim-to-real。
- 规模
- 16 种以上机器人模型,30 多个可直接训练的环境
Isaac Lab 安装要点
来源:isaac-sim.github.io依据官方资料的 v3.0.0 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
安装 uv
官方推荐用 uv 自动安装;Windows 命令见官方文档
curl -LsSf https://astral.sh/uv/install.sh | sh克隆仓库
Windows 克隆前要先开启长路径支持
git clone https://github.com/isaac-sim/IsaacLab.git --branch main cd IsaacLab训练第一个任务
Newton 后端不需要 Isaac Sim,uv 自动装核心依赖
uv run isaaclab train --rl_library rsl_rl \ --task Isaac-Cartpole-Direct physics=newton_mjwarp回放策略
uv run isaaclab play --rl_library rsl_rl --task Isaac-Cartpole-Direct --viz newton_gl启用 Isaac Sim(可选)
首次启动要下载扩展,可能超过十分钟,还要接受 EULA
uv run --extra isaacsim isaaclab train --rl_library rsl_rl \ --task Isaac-Cartpole-Direct physics=isaacsim_physx
环境要求
来源:isaac-sim.github.io- Python
- 3.12,由 uv 自动管理环境
- 系统
- Ubuntu 22.04+(x86_64)、Linux aarch64(含 DGX Spark)、Windows 11(x86_64)
- GPU
- 支持所选 Newton 求解器和 PyTorch 的 NVIDIA GPU;默认 CUDA 13 栈要 Turing 或更新(算力 7.5+)
- NVIDIA 驱动
- Linux x86_64 为 595.58.03,Linux aarch64 为 580.159,Windows x86_64 为 595.97
- CUDA
- 默认环境装 CUDA 13.0 版 PyTorch;标准 wheel 用法不用另装 CUDA Toolkit
- Isaac Sim
- 可选,isaacsim extra 对应 6.2;5.1 及更早版本不再支持
- GLIBC
- Linux 上 isaacsim extra 的 wheel 要 2.35+
- 内存和显存
- Newton 视任务而定;装 Isaac Sim 时 x86_64 工作站至少 32 GB 内存、16 GB 显存和受支持的 RTX GPU
适配矩阵
来源:README.mdIsaac Lab 各版本对应的 Isaac Sim 版本,只在用到 Isaac Sim 的流程里需要匹配
| 名称 | Isaac Sim 版本 |
|---|---|
| release/3.0.0 分支 | 6.2 |
| main 分支 | 6.2 |
| v3.0.0-EA | 6.1 |
| v3.0.0-beta2 | 6.0 |
| v2.3.X | 4.5 / 5.0 / 5.1 |
| v2.2.X | 4.5 / 5.0 |
| v2.1.X | 4.5 |
| v2.0.X | 4.5 |
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
ModuleNotFoundError: No module named 'isaaclab'原因命令大多没有跑在 Isaac Lab 的环境里,不是包漏装
解决在仓库根目录用 uv run 运行;先用下面的命令确认 uv 环境里能导入
来源:isaac-sim.github.iouv run python -c "import isaaclab_tasks; print('ok')"ModuleNotFoundError: No module named 'isaacsim'原因需要 Isaac Sim 的脚本在没装 Isaac Sim 时启动了
解决装上 isaacsim extra,或改跑不需要 Kit 的 Newton 任务
来源:isaac-sim.github.iouv sync --extra isaacsimNo solution found解决重建环境,先装文档指定的 Isaac Sim 版本,再装 Isaac Lab
来源:isaac-sim.github.ioPhysX error: the application need to increase the PxgDynamicsMemoryConfig::foundLostPairsCapacity原因GPU 物理缓冲区只在启动时分配一次,不会动态增长
解决在后端物理配置里调大同名字段,这条报错对应 gpu_found_lost_pairs_capacity
来源:isaac-sim.github.iosim_cfg = sim_utils.SimulationCfg(physics=PhysxCfg(gpu_found_lost_pairs_capacity=2**22))[Error] [omni.kit.livestream.webrtc.plugin] NVST Error: NVST_R_BUSY原因上一个直播进程还占着 WebRTC 信令端口 49100
解决查出占用 49100 的进程,确认可以停止后结束它,再重新启动
来源:isaac-sim.github.iokill $(lsof -ti tcp:49100)DLL load failed while importing _errors原因Windows 上 h5py 3.16.0 的改动导致加载 isaaclab_tasks 时报错
解决升级到含修复的版本:develop 和 release/3.0.0 已把 h5py 导入移到真正用 HDF5 的地方
来源:Issue #5076