Merge branch 'main' into fyu/add_torchrl_wrappers

.aws/mirror-buildspec.yml

@@ -0,0 +1,15 @@
+version: 0.2
+
+phases:
+  install:
+    runtime-versions:
+      nodejs: 14
+  pre_build:
+    commands:
+      - git config --global user.name "Isaac LAB CI Bot"
+      - git config --global user.email "[email protected]"
+  build:
+    commands:
+      - git remote set-url origin https://github.com/${TARGET_REPO}.git
+      - git checkout $SOURCE_BRANCH
+      - git push --force https://[email protected]/${TARGET_REPO}.git $SOURCE_BRANCH:$TARGET_BRANCH

.github/workflows/postmerge-ci-buildspec.yml → .aws/postmerge-ci-buildspec.yml

@@ -34,7 +34,7 @@ phases:
         docker login -u \$oauthtoken -p $NGC_TOKEN nvcr.io
         docker build -t $IMAGE_NAME:$COMBINED_TAG \
           --build-arg ISAACSIM_BASE_IMAGE_ARG=$ISAACSIM_BASE_IMAGE \
-          --build-arg ISAACSIM_VERSION_ARG=4.2.0 \
+          --build-arg ISAACSIM_VERSION_ARG=$ISAACSIM_BASE_VERSION \
           --build-arg ISAACSIM_ROOT_PATH_ARG=/isaac-sim \
           --build-arg ISAACLAB_PATH_ARG=/workspace/isaaclab \
           --build-arg DOCKER_USER_HOME_ARG=/root \

.github/workflows/premerge-ci-buildspec.yml → .aws/premerge-ci-buildspec.yml

@@ -69,7 +69,7 @@ phases:
           cd $SRC_DIR
           DOCKER_BUILDKIT=1 docker build -t isaac-lab-dev \
             --build-arg ISAACSIM_BASE_IMAGE_ARG=$ISAACSIM_BASE_IMAGE \
-            --build-arg ISAACSIM_VERSION_ARG=4.2.0 \
+            --build-arg ISAACSIM_VERSION_ARG=$ISAACSIM_BASE_VERSION \
             --build-arg ISAACSIM_ROOT_PATH_ARG=/isaac-sim \
             --build-arg ISAACLAB_PATH_ARG=/workspace/isaaclab \
             --build-arg DOCKER_USER_HOME_ARG=/root \

.gitattributes

@@ -9,3 +9,4 @@
 *.mp4 filter=lfs diff=lfs merge=lfs -text
 *.pt filter=lfs diff=lfs merge=lfs -text
 *.jit filter=lfs diff=lfs merge=lfs -text
+*.hdf5 filter=lfs diff=lfs merge=lfs -text

.github/LICENSE_HEADER.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2022-2024, The Isaac Lab Project Developers.
+Copyright (c) 2022-2025, The Isaac Lab Project Developers.
 All rights reserved.
 
 SPDX-License-Identifier: BSD-3-Clause

.github/PULL_REQUEST_TEMPLATE.md

@@ -3,7 +3,7 @@
 <!--
 Thank you for your interest in sending a pull request. Please make sure to check the contribution guidelines.
 
-Link: https://isaac-sim.github.io/IsaacLab/source/refs/contributing.html
+Link: https://isaac-sim.github.io/IsaacLab/main/source/refs/contributing.html
 -->
 
 Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context.

.github/workflows/docs.yaml

@@ -1,26 +1,34 @@
 name: Build & deploy docs
 
-on: [push]
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
 
 jobs:
   check-secrets:
     name: Check secrets
     runs-on: ubuntu-latest
     outputs:
-      trigger-build: ${{ steps.trigger-build.outputs.defined }}
+      trigger-deploy: ${{ steps.trigger-deploy.outputs.defined }}
     steps:
-      - id: trigger-build
-        env:
-          REPO_NAME: ${{ secrets.REPO_NAME }}
-          BRANCH_REF: ${{ secrets.BRANCH_REF }}
-        if: "${{ github.repository == env.REPO_NAME && github.ref == env.BRANCH_REF }}"
-        run: echo "defined=true" >> "$GITHUB_OUTPUT"
+    - id: trigger-deploy
+      env:
+        REPO_NAME: ${{ secrets.REPO_NAME }}
+        BRANCH_REF: ${{ secrets.BRANCH_REF }}
+      if: "${{ github.repository == env.REPO_NAME && github.ref == env.BRANCH_REF }}"
+      run: echo "defined=true" >> "$GITHUB_OUTPUT"
 
   build-docs:
-    name: Build and deploy documentation
+    name: Build Docs
     runs-on: ubuntu-latest
     needs: [check-secrets]
-    if: needs.check-secrets.outputs.trigger-build == 'true'
 
     steps:
     - name: Checkout code
@@ -36,12 +44,38 @@ jobs:
       working-directory: ./docs
       run: pip install -r requirements.txt
 
-    - name: Generate docs
+    - name: Check branch docs building
+      working-directory: ./docs
+      if: needs.check-secrets.outputs.trigger-deploy != 'true'
+      run: make current-docs
+
+    - name: Generate multi-version docs
       working-directory: ./docs
-      run: make html
+      run: |
+        git fetch --prune --unshallow --tags
+        make multi-docs
+
+    - name: Upload docs artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: docs-html
+        path: ./docs/_build
+
+  deploy-docs:
+    name: Deploy Docs
+    runs-on: ubuntu-latest
+    needs: [check-secrets, build-docs]
+    if: needs.check-secrets.outputs.trigger-deploy == 'true'
+
+    steps:
+    - name: Download docs artifact
+      uses: actions/download-artifact@v4
+      with:
+        name: docs-html
+        path: ./docs/_build
 
     - name: Deploy to gh-pages
       uses: peaceiris/actions-gh-pages@v3
       with:
         github_token: ${{ secrets.GITHUB_TOKEN }}
-        publish_dir: ./docs/_build/html
+        publish_dir: ./docs/_build

.pre-commit-config.yaml

@@ -38,7 +38,7 @@ repos:
       - id: pyupgrade
         args: ["--py310-plus"]
         # FIXME: This is a hack because Pytorch does not like: torch.Tensor | dict aliasing
-        exclude: "source/extensions/omni.isaac.lab/omni/isaac/lab/envs/common.py"
+        exclude: "source/extensions/omni.isaac.lab/omni/isaac/lab/envs/common.py|source/extensions/omni.isaac.lab/omni/isaac/lab/ui/widgets/image_plot.py"
   - repo: https://github.com/codespell-project/codespell
     rev: v2.2.6
     hooks:

.vscode/tools/settings.template.json

@@ -1,4 +1,9 @@
 {
+    "files.exclude": {
+        "**/.mypy_cache": true,
+        "**/__pycache__": true,
+        "**/*.egg-info": true
+    },
     "files.associations": {
         "*.tpp": "cpp",
         "*.kit": "toml",
@@ -40,7 +45,6 @@
         "teleoperation",
         "xform",
         "numpy",
-        "tensordict",
         "flatcache",
         "physx",
         "dpad",

.vscode/tools/setup_vscode.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2022-2024, The Isaac Lab Project Developers.
+# Copyright (c) 2022-2025, The Isaac Lab Project Developers.
 # All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
@@ -38,8 +38,8 @@
     raise FileNotFoundError(
         f"Could not find the isaac-sim directory: {isaacsim_dir}. There are two possible reasons for this:"
         f"\n\t1. The Isaac Sim directory does not exist as a symlink at: {os.path.join(ISAACLAB_DIR, '_isaac_sim')}"
-        "\n\t2. The script could import the 'isaacsim' package. This could be due to the 'isaacsim' package not being "
-        "installed in the Python environment.\n"
+        "\n\t2. The script could not import the 'isaacsim' package. This could be due to the 'isaacsim' package not "
+        "being installed in the Python environment.\n"
         "\nPlease make sure that the Isaac Sim directory exists or that the 'isaacsim' package is installed."
     )
 

CONTRIBUTING.md

@@ -5,4 +5,4 @@ the framework more mature and useful for everyone. These may happen in forms of
 design proposals and more.
 
 For general information on how to contribute see
-<https://isaac-sim.github.io/IsaacLab/source/refs/contributing.html>.
+<https://isaac-sim.github.io/IsaacLab/main/source/refs/contributing.html>.

CONTRIBUTORS.md

@@ -6,7 +6,7 @@ To see the full list of contributors, please check the revision history in the s
 
 Guidelines for modifications:
 
-* Please keep the lists sorted alphabetically.
+* Please keep the **lists sorted alphabetically**.
 * Names should be added to this file as: *individual names* or *organizations*.
 * E-mail addresses are tracked elsewhere to avoid spam.
 
@@ -19,6 +19,7 @@ Guidelines for modifications:
 
 ---
 
+* Antonio Serrano-Muñoz
 * David Hoeller
 * Farbod Farshidian
 * Hunter Hansen
@@ -28,45 +29,63 @@ Guidelines for modifications:
 * Mayank Mittal
 * Nikita Rudin
 * Pascal Roth
+* Sheikh Dawood
 
 ## Contributors
 
 * Alice Zhou
 * Amr Mousa
 * Andrej Orsula
 * Anton Bjørndahl Mortensen
-* Antonio Serrano-Muñoz
 * Arjun Bhardwaj
 * Brayden Zhang
 * Calvin Yu
 * Chenyu Yang
+* CY (Chien-Ying) Chen
 * David Yang
+* Dorsa Rohani
+* Felix Yu
 * Gary Lvov
+* Giulio Romualdi
+* Haoran Zhou
 * HoJin Jeon
+* Hongwei Xiong
+* Iretiayo Akinola
+* Jan Kerner
 * Jean Tampon
 * Jia Lin Yuan
+* Jinghuan Shang
 * Jingzhou Liu
 * Johnson Sun
 * Kaixi Bao
 * Kourosh Darvish
 * Lionel Gulich
+* Louis Le Lay
 * Lorenz Wellhausen
 * Masoud Moghani
 * Michael Gussert
+* Michael Noseworthy
 * Muhong Guo
+* Nicola Loi
 * Nuralem Abizov
+* Oyindamola Omotuyi
 * Özhan Özen
+* Peter Du
+* Qian Wan
 * Qinxi Yu
 * René Zurbrügg
 * Ritvik Singh
 * Rosario Scalise
+* Ryley McCarroll
 * Shafeef Omar
+* Stephan Pleines
 * Vladimir Fokow
+* Wei Yang
 * Xavier Nal
 * Yang Jin
+* Yujian Zhang
 * Zhengyu Zhang
 * Ziqi Fan
-* Qian Wan
 
 ## Acknowledgements
 
@@ -76,3 +95,4 @@ Guidelines for modifications:
 * Gavriel State
 * Hammad Mazhar
 * Marco Hutter
+* Yashraj Narang

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2022-2024, The Isaac Lab Project Developers.
+Copyright (c) 2022-2025, The Isaac Lab Project Developers.
 
 All rights reserved.
 

README.md

@@ -13,23 +13,38 @@
 [![License](https://img.shields.io/badge/license-BSD--3-yellow.svg)](https://opensource.org/licenses/BSD-3-Clause)
 
 
-**Isaac Lab** is a unified and modular framework for robot learning that aims to simplify common workflows
-in robotics research (such as RL, learning from demonstrations, and motion planning). It is built upon
-[NVIDIA Isaac Sim](https://docs.omniverse.nvidia.com/isaacsim/latest/overview.html) to leverage the latest
-simulation capabilities for photo-realistic scenes and fast and accurate simulation.
+**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.omniverse.nvidia.com/isaacsim/latest/overview.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.
+
+## 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
+- **Sensors**: RGB/depth/segmentation cameras, camera annotations, IMU, contact sensors, ray casters.
+
+
+## Getting Started
+
+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)
+- [Tutorials](https://isaac-sim.github.io/IsaacLab/main/source/tutorials/index.html)
+- [Available environments](https://isaac-sim.github.io/IsaacLab/main/source/overview/environments.html)
 
-Please refer to our [documentation page](https://isaac-sim.github.io/IsaacLab) to learn more about the
-installation steps, features, tutorials, and how to set up your project with Isaac Lab.
 
 ## Contributing to Isaac Lab
 
 We wholeheartedly welcome contributions from the community to make this framework mature and useful for everyone.
 These may happen as bug reports, feature requests, or code contributions. For details, please check our
-[contribution guidelines](https://isaac-sim.github.io/IsaacLab/source/refs/contributing.html).
+[contribution guidelines](https://isaac-sim.github.io/IsaacLab/main/source/refs/contributing.html).
 
 ## Troubleshooting
 
-Please see the [troubleshooting](https://isaac-sim.github.io/IsaacLab/source/refs/troubleshooting.html) section for
+Please see the [troubleshooting](https://isaac-sim.github.io/IsaacLab/main/source/refs/troubleshooting.html) section for
 common fixes or [submit an issue](https://github.com/isaac-sim/IsaacLab/issues).
 
 For issues related to Isaac Sim, we recommend checking its [documentation](https://docs.omniverse.nvidia.com/app_isaacsim/app_isaacsim/overview.html)

VERSION

@@ -1 +1 @@
-1.2.0
+1.4.0

docker/Dockerfile.base

@@ -1,4 +1,4 @@
-# Copyright (c) 2022-2024, The Isaac Lab Project Developers.
+# Copyright (c) 2022-2025, The Isaac Lab Project Developers.
 # All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause