Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
48 commits
Select commit Hold shift + click to select a range
3ca87e9
Disables generate internal template when detecting isaaclab install v…
ooctipus Aug 27, 2025
3d3af0b
Fixes typo in isaaclab.bat (#3272)
ooctipus Aug 27, 2025
b3f6b31
Enhances Pink IK controller with null-space posture control and impro…
michaellin6 Aug 27, 2025
66f4877
Fix typo in list_envs.py script path (#3282)
fbeltrao Aug 27, 2025
3edc06c
Fixes distributed training hanging issue (#3273)
kellyguo11 Aug 27, 2025
d2bdbe3
Disables verbose printing in conftest.py (#3291)
ooctipus Aug 27, 2025
f1ca087
Removes isaaclab.controller import of Pink IK to prevent pinocchio im…
michaellin6 Aug 28, 2025
1b2d6ea
Fixes `terrain_out_of_bounds` to return tensor instead of bool (#3180)
fan-ziqi Aug 28, 2025
a80fa53
Disables CI reporting for PRs created from the forks (#3209)
nv-apoddubny Aug 28, 2025
8608fbc
Fixes template docs and restructure imitation learning docs (#3283)
pascal-roth Aug 29, 2025
0f00ca2
Updates version and release notes for v2.2.1 (#3296)
Mayankm96 Aug 29, 2025
c91a125
Fixes missing visible attribute in spawn_ground_plane (#3304)
kellyguo11 Sep 1, 2025
82b24dd
Adds changes for rsl_rl 3.0.1 (#2962)
ClemensSchwarke Sep 2, 2025
dddd51d
Adds YAML Resource Specification To Ray Integration (#2847)
binw666 Sep 2, 2025
2f9298d
Simplifies cross platform installation setup.py (#3294)
ooctipus Sep 3, 2025
5dae83e
Fixes the reach task regression with teleop devices returning the gri…
rwiltz Sep 3, 2025
e57da49
Moves parameter `platform_height` to the correct mesh terrain configu…
Mayankm96 Sep 4, 2025
4eae06f
Updates locomanip task name and link in docs (#3342)
fan-ziqi Sep 4, 2025
fb270ab
Improves recorder performance and add additional recording capability…
peterd-NV Sep 5, 2025
90e5f31
Adds task Reach-UR10e, an end-effector tracking environment (#3147)
ashwinvkNV Sep 5, 2025
d7613ce
Supports rl games wrapper with dictionary observation (#3340)
ooctipus Sep 5, 2025
6c06a58
Adds a configuration example for Student-Teacher Distillation (#3100)
ClemensSchwarke Sep 5, 2025
7af1d72
Fixes invalid callbacks for debug vis when simulation is restarted (#…
kellyguo11 Sep 5, 2025
73aa877
Change GLIBC version requirement to 2.35 for pip (#3360)
GiulioRomualdi Sep 5, 2025
3422782
Adds surface gripper support in manager-based workflow (#3174)
rebeccazhang0707 Sep 5, 2025
1a71e24
Fixes the missing Ray initialization (#3350)
ozhanozen Sep 5, 2025
cc7685b
Disables GPU testing for suction gripper environments (#3373)
kellyguo11 Sep 7, 2025
e0a8df2
Fixes errors while building the docs (#3370)
Mayankm96 Sep 8, 2025
314e515
Moves location of serve file check to the correct module (#3368)
Mayankm96 Sep 8, 2025
2e2c57c
Deletes unused asset.py in isaaclab (#3389)
fan-ziqi Sep 8, 2025
152eeb2
Adds support for manus and vive (#3357)
cathyliyuanchen Sep 9, 2025
20c3dfa
Updates Isaac Sim license (#3393)
kellyguo11 Sep 9, 2025
9d194dc
Adds two new robots with grippers (#3229)
rebeccazhang0707 Sep 9, 2025
e4b5681
Adds notification widgets at IK error status and Teleop task completi…
lotusl-code Sep 9, 2025
bc7e5d7
Adds galbot stack cube tasks, with left_arm_gripper and right_arm_suc…
rebeccazhang0707 Sep 9, 2025
994979c
Adds SkillGen framework to Isaac Lab with cuRobo support (#3303)
njawale42 Sep 9, 2025
48054b6
feat: Add G1/GR1 IK environments, teleop system, and locomanipulation…
michaellin6 Aug 29, 2025
19074b5
documention update
michaellin6 Sep 5, 2025
17f5e56
fixing pinnochio import for ik unit tests
michaellin6 Sep 8, 2025
ccb019c
updated unitree G1 asset address to public server
michaellin6 Sep 8, 2025
8f96201
removing import of pick place for locomanipulation to avoid pinocchio…
michaellin6 Sep 8, 2025
39b3090
moved load_torchscript into isaaclab.io/
michaellin6 Sep 8, 2025
eefd3a4
fixing linting
michaellin6 Sep 9, 2025
a9afae2
fixed existing bug on main
michaellin6 Sep 9, 2025
69f3412
Adds a unit tests for catching non-headless app file launch (#3392)
kellyguo11 Sep 9, 2025
7ee6d2a
Clarifies asset classes' default_inertia tensor coordinate frame (#3405)
preist-nvidia Sep 9, 2025
e4f1ef9
Moving G1 retageting files under trihand
rwiltz Sep 9, 2025
daffb29
Merge branch 'main' into team/locomanipulation-integration
kellyguo11 Sep 9, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion .github/actions/docker-build/action.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ inputs:
required: true
dockerfile-path:
description: 'Path to Dockerfile'
default: 'docker/Dockerfile.base'
default: 'docker/Dockerfile.curobo'
required: false
context-path:
description: 'Build context path'
Expand Down
9 changes: 9 additions & 0 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,7 @@ jobs:
isaacsim-version: ${{ env.ISAACSIM_BASE_VERSION }}

- name: Run General Tests
id: run-general-tests
uses: ./.github/actions/run-tests
with:
test-path: "tools"
Expand All @@ -120,6 +121,12 @@ jobs:
retention-days: 1
compression-level: 9

- name: Fail on Test Failure for Fork PRs
if: github.event.pull_request.head.repo.full_name != github.repository && steps.run-general-tests.outcome == 'failure'
run: |
echo "Tests failed for PR from fork. The test report is in the logs. Failing the job."
exit 1

combine-results:
needs: [test-isaaclab-tasks, test-general]
runs-on: [self-hosted, gpu]
Expand Down Expand Up @@ -166,6 +173,7 @@ jobs:

- name: Comment on Test Results
id: test-reporter
if: github.event.pull_request.head.repo.full_name == github.repository
uses: EnricoMi/publish-unit-test-result-action@v2
with:
files: "reports/combined-results.xml"
Expand All @@ -179,6 +187,7 @@ jobs:
action_fail_on_inconclusive: true

- name: Report Test Results
if: github.event.pull_request.head.repo.full_name == github.repository
uses: dorny/test-reporter@v1
with:
name: IsaacLab Build and Test Results
Expand Down
15 changes: 15 additions & 0 deletions .github/workflows/license-exceptions.json
Original file line number Diff line number Diff line change
Expand Up @@ -385,5 +385,20 @@
"package": "typing-inspection",
"license" : "UNKNOWN",
"comment": "MIT"
},
{
"package": "ml_dtypes",
"license" : "UNKNOWN",
"comment": "Apache 2.0"
},
{
"package": "zipp",
"license" : "UNKNOWN",
"comment": "MIT"
},
{
"package": "fsspec",
"license" : "UNKNOWN",
"comment": "BSD"
}
]
2 changes: 1 addition & 1 deletion CITATION.cff
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
cff-version: 1.2.0
message: "If you use this software, please cite both the Isaac Lab repository and the Orbit paper."
title: Isaac Lab
version: 2.2.0
version: 2.2.1
repository-code: https://github.com/NVIDIA-Omniverse/IsaacLab
type: software
authors:
Expand Down
11 changes: 10 additions & 1 deletion CONTRIBUTORS.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ Guidelines for modifications:

* Antonio Serrano-Muñoz
* Ben Johnston
* Clemens Schwarke
* David Hoeller
* Farbod Farshidian
* Hunter Hansen
Expand Down Expand Up @@ -52,9 +53,9 @@ Guidelines for modifications:
* Brian Bingham
* Cameron Upright
* Calvin Yu
* Cathy Y. Li
* Cheng-Rong Lai
* Chenyu Yang
* Clemens Schwarke
* Connor Smith
* CY (Chien-Ying) Chen
* David Yang
Expand All @@ -70,6 +71,7 @@ Guidelines for modifications:
* HoJin Jeon
* Hongwei Xiong
* Hongyu Li
* Huihua Zhao
* Iretiayo Akinola
* Jack Zeng
* Jan Kerner
Expand All @@ -86,6 +88,7 @@ Guidelines for modifications:
* Kourosh Darvish
* Kousheek Chakraborty
* Lionel Gulich
* Lotus Li
* Louis Le Lay
* Lorenz Wellhausen
* Lukas Fröhlich
Expand All @@ -94,9 +97,11 @@ Guidelines for modifications:
* Maurice Rahme
* Michael Gussert
* Michael Noseworthy
* Michael Lin
* Miguel Alonso Jr
* Mingyu Lee
* Muhong Guo
* Neel Anand Jawale
* Nicola Loi
* Norbert Cygiert
* Nuoyan Chen (Alvin)
Expand All @@ -106,6 +111,7 @@ Guidelines for modifications:
* Özhan Özen
* Patrick Yin
* Peter Du
* Philipp Reist
* Pulkit Goyal
* Qian Wan
* Qinxi Yu
Expand All @@ -115,6 +121,7 @@ Guidelines for modifications:
* Ritvik Singh
* Rosario Scalise
* Ryley McCarroll
* Sergey Grizan
* Shafeef Omar
* Shaoshu Su
* Shaurya Dewan
Expand All @@ -138,6 +145,7 @@ Guidelines for modifications:
* Ziqi Fan
* Zoe McCarthy
* David Leon
* Song Yi

## Acknowledgements

Expand All @@ -147,4 +155,5 @@ Guidelines for modifications:
* Gavriel State
* Hammad Mazhar
* Marco Hutter
* Yan Chang
* Yashraj Narang
53 changes: 35 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,21 @@
[![License](https://img.shields.io/badge/license-Apache--2.0-yellow.svg)](https://opensource.org/license/apache-2-0)


**Isaac Lab** is a GPU-accelerated, open-source framework designed to unify and simplify robotics research workflows, such as reinforcement learning, imitation learning, and motion planning. Built on [NVIDIA Isaac Sim](https://docs.isaacsim.omniverse.nvidia.com/latest/index.html), it combines fast and accurate physics and sensor simulation, making it an ideal choice for sim-to-real transfer in robotics.
**Isaac Lab** is a GPU-accelerated, open-source framework designed to unify and simplify robotics research workflows,
such as reinforcement learning, imitation learning, and motion planning. Built on [NVIDIA Isaac Sim](https://docs.isaacsim.omniverse.nvidia.com/latest/index.html),
it combines fast and accurate physics and sensor simulation, making it an ideal choice for sim-to-real
transfer in robotics.

Isaac Lab provides developers with a range of essential features for accurate sensor simulation, such as RTX-based cameras, LIDAR, or contact sensors. The framework's GPU acceleration enables users to run complex simulations and computations faster, which is key for iterative processes like reinforcement learning and data-intensive tasks. Moreover, Isaac Lab can run locally or be distributed across the cloud, offering flexibility for large-scale deployments.
Isaac Lab provides developers with a range of essential features for accurate sensor simulation, such as RTX-based
cameras, LIDAR, or contact sensors. The framework's GPU acceleration enables users to run complex simulations and
computations faster, which is key for iterative processes like reinforcement learning and data-intensive tasks.
Moreover, Isaac Lab can run locally or be distributed across the cloud, offering flexibility for large-scale deployments.


## Key Features

Isaac Lab offers a comprehensive set of tools and environments designed to facilitate robot learning:

- **Robots**: A diverse collection of robots, from manipulators, quadrupeds, to humanoids, with 16 commonly available models.
- **Environments**: Ready-to-train implementations of more than 30 environments, which can be trained with popular reinforcement learning frameworks such as RSL RL, SKRL, RL Games, or Stable Baselines. We also support multi-agent reinforcement learning.
- **Physics**: Rigid bodies, articulated systems, deformable objects
Expand Down Expand Up @@ -118,7 +125,8 @@ For detailed Isaac Sim installation instructions, please refer to

### Documentation

Our [documentation page](https://isaac-sim.github.io/IsaacLab) provides everything you need to get started, including detailed tutorials and step-by-step guides. Follow these links to learn more about:
Our [documentation page](https://isaac-sim.github.io/IsaacLab) provides everything you need to get started, including
detailed tutorials and step-by-step guides. Follow these links to learn more about:

- [Installation steps](https://isaac-sim.github.io/IsaacLab/main/source/setup/installation/index.html#local-installation)
- [Reinforcement learning](https://isaac-sim.github.io/IsaacLab/main/source/overview/reinforcement-learning/rl_existing_scripts.html)
Expand All @@ -128,18 +136,16 @@ Our [documentation page](https://isaac-sim.github.io/IsaacLab) provides everythi

## Isaac Sim Version Dependency

Isaac Lab is built on top of Isaac Sim and requires specific versions of Isaac Sim that are compatible with each release of Isaac Lab.
Below, we outline the recent Isaac Lab releases and GitHub branches and their corresponding dependency versions for Isaac Sim.
Isaac Lab is built on top of Isaac Sim and requires specific versions of Isaac Sim that are compatible with each
release of Isaac Lab. Below, we outline the recent Isaac Lab releases and GitHub branches and their corresponding
dependency versions for Isaac Sim.

| Isaac Lab Version | Isaac Sim Version |
| ----------------------------- | ------------------- |
| `main` branch | Isaac Sim 4.5 / 5.0 |
| `v2.2.0` | Isaac Sim 4.5 / 5.0 |
| `v2.1.1` | Isaac Sim 4.5 |
| `v2.1.0` | Isaac Sim 4.5 |
| `v2.0.2` | Isaac Sim 4.5 |
| `v2.0.1` | Isaac Sim 4.5 |
| `v2.0.0` | Isaac Sim 4.5 |
| `v2.2.X` | Isaac Sim 4.5 / 5.0 |
| `v2.1.X` | Isaac Sim 4.5 |
| `v2.0.X` | Isaac Sim 4.5 |


## Contributing to Isaac Lab
Expand All @@ -150,8 +156,8 @@ These may happen as bug reports, feature requests, or code contributions. For de

## Show & Tell: Share Your Inspiration

We encourage you to utilize our [Show & Tell](https://github.com/isaac-sim/IsaacLab/discussions/categories/show-and-tell) area in the
`Discussions` section of this repository. This space is designed for you to:
We encourage you to utilize our [Show & Tell](https://github.com/isaac-sim/IsaacLab/discussions/categories/show-and-tell)
area in the `Discussions` section of this repository. This space is designed for you to:

* Share the tutorials you've created
* Showcase your learning content
Expand All @@ -171,8 +177,11 @@ or opening a question on its [forums](https://forums.developer.nvidia.com/c/agx-

## Support

* Please use GitHub [Discussions](https://github.com/isaac-sim/IsaacLab/discussions) for discussing ideas, asking questions, and requests for new features.
* Github [Issues](https://github.com/isaac-sim/IsaacLab/issues) should only be used to track executable pieces of work with a definite scope and a clear deliverable. These can be fixing bugs, documentation issues, new features, or general updates.
* Please use GitHub [Discussions](https://github.com/isaac-sim/IsaacLab/discussions) for discussing ideas,
asking questions, and requests for new features.
* Github [Issues](https://github.com/isaac-sim/IsaacLab/issues) should only be used to track executable pieces of
work with a definite scope and a clear deliverable. These can be fixing bugs, documentation issues, new features,
or general updates.

## Connect with the NVIDIA Omniverse Community

Expand All @@ -182,15 +191,23 @@ to spotlight your work.

You can also join the conversation on the [Omniverse Discord](https://discord.com/invite/nvidiaomniverse) to
connect with other developers, share your projects, and help grow a vibrant, collaborative ecosystem
where creativity and technology intersect. Your contributions can make a meaningful impact on the Isaac Lab community and beyond!
where creativity and technology intersect. Your contributions can make a meaningful impact on the Isaac Lab
community and beyond!

## License

The Isaac Lab framework is released under [BSD-3 License](LICENSE). The `isaaclab_mimic` extension and its corresponding standalone scripts are released under [Apache 2.0](LICENSE-mimic). The license files of its dependencies and assets are present in the [`docs/licenses`](docs/licenses) directory.
The Isaac Lab framework is released under [BSD-3 License](LICENSE). The `isaaclab_mimic` extension and its
corresponding standalone scripts are released under [Apache 2.0](LICENSE-mimic). The license files of its
dependencies and assets are present in the [`docs/licenses`](docs/licenses) directory.

Note that Isaac Lab requires Isaac Sim, which includes components under proprietary licensing terms. Please see the [Isaac Sim license](docs/licenses/dependencies/isaacsim-license.txt) for information on Isaac Sim licensing.

Note that the `isaaclab_mimic` extension requires cuRobo, which has proprietary licensing terms that can be found in [`docs/licenses/dependencies/cuRobo-license.txt`](docs/licenses/dependencies/cuRobo-license.txt).

## Acknowledgement

Isaac Lab development initiated from the [Orbit](https://isaac-orbit.github.io/) framework. We would appreciate if you would cite it in academic publications as well:
Isaac Lab development initiated from the [Orbit](https://isaac-orbit.github.io/) framework. We would appreciate if
you would cite it in academic publications as well:

```
@article{mittal2023orbit,
Expand Down
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
2.2.0
2.2.1
2 changes: 1 addition & 1 deletion apps/isaaclab.python.headless.kit
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
[package]
title = "Isaac Lab Python Headless"
description = "An app for running Isaac Lab headlessly"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "isaaclab", "python", "headless"]
Expand Down
5 changes: 4 additions & 1 deletion apps/isaaclab.python.headless.rendering.kit
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
[package]
title = "Isaac Lab Python Headless Camera"
description = "An app for running Isaac Lab headlessly with rendering enabled"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "isaaclab", "python", "camera", "minimal"]
Expand Down Expand Up @@ -83,6 +83,9 @@ app.updateOrder.checkForHydraRenderComplete = 1000
app.renderer.waitIdle=true
app.hydraEngine.waitIdle=true

# Forces serial processing for omni graph to avoid NCCL timeout hangs in distributed training
app.execution.debug.forceSerial = true

app.audio.enabled = false

# Enable Vulkan - avoids torch+cu12 error on windows
Expand Down
2 changes: 1 addition & 1 deletion apps/isaaclab.python.kit
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
[package]
title = "Isaac Lab Python"
description = "An app for running Isaac Lab"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "usd"]
Expand Down
2 changes: 1 addition & 1 deletion apps/isaaclab.python.rendering.kit
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
[package]
title = "Isaac Lab Python Camera"
description = "An app for running Isaac Lab with rendering enabled"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "isaaclab", "python", "camera", "minimal"]
Expand Down
2 changes: 1 addition & 1 deletion apps/isaaclab.python.xr.openxr.headless.kit
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
[package]
title = "Isaac Lab Python OpenXR Headless"
description = "An app for running Isaac Lab with OpenXR in headless mode"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "usd", "headless"]
Expand Down
2 changes: 1 addition & 1 deletion apps/isaaclab.python.xr.openxr.kit
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
[package]
title = "Isaac Lab Python OpenXR"
description = "An app for running Isaac Lab with OpenXR"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "usd"]
Expand Down
2 changes: 1 addition & 1 deletion apps/isaacsim_4_5/isaaclab.python.headless.kit
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
[package]
title = "Isaac Lab Python Headless"
description = "An app for running Isaac Lab headlessly"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "isaaclab", "python", "headless"]
Expand Down
2 changes: 1 addition & 1 deletion apps/isaacsim_4_5/isaaclab.python.headless.rendering.kit
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
[package]
title = "Isaac Lab Python Headless Camera"
description = "An app for running Isaac Lab headlessly with rendering enabled"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "isaaclab", "python", "camera", "minimal"]
Expand Down
2 changes: 1 addition & 1 deletion apps/isaacsim_4_5/isaaclab.python.kit
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
[package]
title = "Isaac Lab Python"
description = "An app for running Isaac Lab"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "usd"]
Expand Down
2 changes: 1 addition & 1 deletion apps/isaacsim_4_5/isaaclab.python.rendering.kit
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
[package]
title = "Isaac Lab Python Camera"
description = "An app for running Isaac Lab with rendering enabled"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "isaaclab", "python", "camera", "minimal"]
Expand Down
2 changes: 1 addition & 1 deletion apps/isaacsim_4_5/isaaclab.python.xr.openxr.headless.kit
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
[package]
title = "Isaac Lab Python OpenXR Headless"
description = "An app for running Isaac Lab with OpenXR in headless mode"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "usd", "headless"]
Expand Down
2 changes: 1 addition & 1 deletion apps/isaacsim_4_5/isaaclab.python.xr.openxr.kit
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
[package]
title = "Isaac Lab Python OpenXR"
description = "An app for running Isaac Lab with OpenXR"
version = "2.2.0"
version = "2.2.1"

# That makes it browsable in UI with "experience" filter
keywords = ["experience", "app", "usd"]
Expand Down
Loading