Installing Isaac Lab through Pip

Installing Isaac Lab through Pip#

From Isaac Lab 2.0, pip packages are provided to install both Isaac Sim and Isaac Lab extensions from pip. Note that this installation process is only recommended for advanced users working on additional extension projects that are built on top of Isaac Lab. Isaac Lab pip packages do not include any standalone python scripts for training, inferencing, or running standalone workflows such as demos and examples. Therefore, users are required to define your own runner scripts when installing Isaac Lab from pip.

To learn about how to set up your own extension project on top of Isaac Lab, visit Extension Template.

Note

If you use Conda, we recommend using Miniconda.

  • To use the pip installation approach for Isaac Lab, we recommend first creating a virtual environment. Ensure that the python version of the virtual environment is Python 3.10.

    conda create -n env_isaaclab python=3.10
conda activate env_isaaclab

    # create a virtual environment named env_isaaclab with python3.10
python3.10 -m venv env_isaaclab
# activate the virtual environment
source env_isaaclab/bin/activate

    # create a virtual environment named env_isaaclab with python3.10
python3.10 -m venv env_isaaclab
# activate the virtual environment
env_isaaclab\Scripts\activate

  • Next, install a CUDA-enabled PyTorch 2.5.1 build based on the CUDA version available on your system. This step is optional for Linux, but required for Windows to ensure a CUDA-compatible version of PyTorch is installed.

    pip install torch==2.5.1 --index-url https://download.pytorch.org/whl/cu118

    pip install torch==2.5.1 --index-url https://download.pytorch.org/whl/cu121

  • Before installing Isaac Lab, ensure the latest pip version is installed. To update pip, run

    pip install --upgrade pip

    python -m pip install --upgrade pip

  • Then, install the Isaac Lab packages, this will also install Isaac Sim.

    pip install isaaclab[isaacsim,all]==2.0.0 --extra-index-url https://pypi.nvidia.com

Verifying the Isaac Sim installation#

  • Make sure that your virtual environment is activated (if applicable)

  • Check that the simulator runs as expected:

    # note: you can pass the argument "--help" to see all arguments possible.
isaacsim

  • It’s also possible to run with a specific experience file, run:

    # experience files can be absolute path, or relative path searched in isaacsim/apps or omni/apps
isaacsim isaacsim.exp.full.kit

Attention

When running Isaac Sim for the first time, all dependent extensions will be pulled from the registry. This process can take upwards of 10 minutes and is required on the first run of each experience file. Once the extensions are pulled, consecutive runs using the same experience file will use the cached extensions.

Attention

The first run will prompt users to accept the Nvidia Omniverse License Agreement. To accept the EULA, reply Yes when prompted with the below message:

By installing or using Isaac Sim, I agree to the terms of NVIDIA OMNIVERSE LICENSE AGREEMENT (EULA)
in https://docs.isaacsim.omniverse.nvidia.com/latest/common/NVIDIA_Omniverse_License_Agreement.html

Do you accept the EULA? (Yes/No): Yes

If the simulator does not run or crashes while following the above instructions, it means that something is incorrectly configured. To debug and troubleshoot, please check Isaac Sim documentation and the forums.

Running Isaac Lab Scripts#

By following the above scripts, your python environment should now have access to all of the Isaac Lab extensions. To run a user-defined script for Isaac Lab, simply run

python my_awesome_script.py