仿真器开源

Isaac Lab

NVIDIA、ETH Zurich美国

GitHub 仓库 isaac-sim/IsaacLab

又称 IsaacLab、NVIDIA Isaac Lab、Orbit

类别
仿真与评测 · 仿真器
开放程度
开源
发布时间
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。版本更新后命令可能变化,以官方文档为准。

  1. 安装 uv

    官方推荐用 uv 自动安装;Windows 命令见官方文档

    curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 克隆仓库

    Windows 克隆前要先开启长路径支持

    git clone https://github.com/isaac-sim/IsaacLab.git --branch main
    cd IsaacLab
  3. 训练第一个任务

    Newton 后端不需要 Isaac Sim,uv 自动装核心依赖

    uv run isaaclab train --rl_library rsl_rl \
       --task Isaac-Cartpole-Direct physics=newton_mjwarp
  4. 回放策略

    uv run isaaclab play --rl_library rsl_rl --task Isaac-Cartpole-Direct --viz newton_gl
  5. 启用 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.md

Isaac Lab 各版本对应的 Isaac Sim 版本,只在用到 Isaac Sim 的流程里需要匹配

名称Isaac Sim 版本
release/3.0.0 分支6.2
main 分支6.2
v3.0.0-EA6.1
v3.0.0-beta26.0
v2.3.X4.5 / 5.0 / 5.1
v2.2.X4.5 / 5.0
v2.1.X4.5
v2.0.X4.5

常见报错

解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。

ModuleNotFoundError: No module named 'isaaclab'

原因命令大多没有跑在 Isaac Lab 的环境里,不是包漏装

解决在仓库根目录用 uv run 运行;先用下面的命令确认 uv 环境里能导入

uv run python -c "import isaaclab_tasks; print('ok')"
来源:isaac-sim.github.io
ModuleNotFoundError: No module named 'isaacsim'

原因需要 Isaac Sim 的脚本在没装 Isaac Sim 时启动了

解决装上 isaacsim extra,或改跑不需要 Kit 的 Newton 任务

uv sync --extra isaacsim
来源:isaac-sim.github.io
No solution found

解决重建环境,先装文档指定的 Isaac Sim 版本,再装 Isaac Lab

来源:isaac-sim.github.io
PhysX error: the application need to increase the PxgDynamicsMemoryConfig::foundLostPairsCapacity

原因GPU 物理缓冲区只在启动时分配一次,不会动态增长

解决在后端物理配置里调大同名字段,这条报错对应 gpu_found_lost_pairs_capacity

sim_cfg = sim_utils.SimulationCfg(physics=PhysxCfg(gpu_found_lost_pairs_capacity=2**22))
来源:isaac-sim.github.io
[Error] [omni.kit.livestream.webrtc.plugin] NVST Error: NVST_R_BUSY

原因上一个直播进程还占着 WebRTC 信令端口 49100

解决查出占用 49100 的进程,确认可以停止后结束它,再重新启动

kill $(lsof -ti tcp:49100)
来源:isaac-sim.github.io
DLL load failed while importing _errors

原因Windows 上 h5py 3.16.0 的改动导致加载 isaaclab_tasks 时报错

解决升级到含修复的版本:develop 和 release/3.0.0 已把 h5py 导入移到真正用 HDF5 的地方

来源:Issue #5076

获取方式

数据来源

本页信息均整理自以下公开资料。

6 条来源核验于 2026-10-01

星标、下载量等指标定期自动更新。

Isaac Lab:安装步骤、环境要求与常见报错 | 具身集