[bug] Executing `./isaaclab.sh --install` fails

[ysheng777]

Describe the bug

When following the documentation to install IsaacLab 2.3.2 with IsaacSim 5.1.0, IsaacSim installs successfully, but IsaacLab installation fails.

Steps to reproduce

Follow the installation instructions from the official guide:
https://isaac-sim.github.io/IsaacLab/v2.3.2/source/setup/installation/pip_installation.html

# Attempt to install IsaacLab
./isaaclab.sh --install

### Error messages:  
-Wheel build failure:  

Getting requirements to build wheel ... error
error: subprocess-exited-with-error

× Getting requirements to build wheel did not run successfully.
│ exit code: 1
╰─> [20 lines of output]
    Traceback (most recent call last):
      File "/home/xxx/miniconda3/envs/env_isaaclab_v232/lib/python3.11/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 389, in <module>
        main()
      File "/home/xxx/miniconda3/envs/env_isaaclab_v232/lib/python3.11/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 373, in main
        json_out["return_val"] = hook(**hook_input["kwargs"])
                                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      File "/home/xxx/miniconda3/envs/env_isaaclab_v232/lib/python3.11/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 143, in get_requires_for_build_wheel
        return hook(config_settings)
               ^^^^^^^^^^^^^^^^^^^^^
      File "/tmp/pip-build-env-fiw4vbtb/overlay/lib/python3.11/site-packages/setuptools/build_meta.py", line 333, in get_requires_for_build_wheel
        return self._get_build_requires(config_settings, requirements=[])
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      File "/tmp/pip-build-env-fiw4vbtb/overlay/lib/python3.11/site-packages/setuptools/build_meta.py", line 301, in _get_build_requires
        self.run_setup()
      File "/tmp/pip-build-env-fiw4vbtb/overlay/lib/python3.11/site-packages/setuptools/build_meta.py", line 520, in run_setup
        super().run_setup(setup_script=setup_script)
      File "/tmp/pip-build-env-fiw4vbtb/overlay/lib/python3.11/site-packages/setuptools/build_meta.py", line 317, in run_setup
        exec(code, locals())
      File "<string>", line 1, in <module>
    ModuleNotFoundError: No module named 'pkg_resources'


-ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. isaacsim-kernel 5.1.0.0 requires psutil==5.9.8, but you have psutil 7.2.2 which is incompatible.


-ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. isaacsim-kernel 5.1.0.0 requires click==8.1.7, but you have click 8.4.0 which is incompatible. ipython 9.13.0 requires psutil>=7, but you have psutil 5.9.8 which is incompatible.


-ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. isaacsim-kernel 5.1.0.0 requires click==8.1.7, but you have click 8.4.0 which is incompatible. isaacsim-kernel 5.1.0.0 requires psutil==5.9.8, but you have psutil 7.2.2 which is incompatible. rl-games 1.6.1 requires psutil<6.0.0,>=5.9.0, but you have psutil 7.2.2 which is incompatible.

System Info

Isaac Sim Version: 5.1.0
Isaac Lab Version: 2.3.2
OS: Ubuntu 24.04 LTS
GPU: NVIDIA GeForce RTX 5060
CUDA Version: 13.0
GPU Driver: 580.159.03
Python Version: 3.11.15
pip Version: 26.1.1
conda Version: 26.3.2

[d-kleine]

Please see #4576

[ysheng777]

Thanks ！

I tried the method described there, and it did indeed resolve the "wheel" issue, but conflicts still persist.

  ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. isaacsim-kernel 5.1.0.0 requires click==8.1.7, but you have click 8.4.0 which is incompatible. ipython 9.13.0 requires psutil>=7, but you have psutil 5.9.8 which is incompatible.
  
  ...
  
  ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. isaacsim-kernel 5.1.0.0 requires click==8.1.7, but you have click 8.4.0 which is incompatible. isaacsim-kernel 5.1.0.0 requires psutil==5.9.8, but you have psutil 7.2.2 which is incompatible. rl-games 1.6.1 requires psutil<6.0.0,>=5.9.0, but you have psutil 7.2.2 which is incompatible.

Ultimately, I modified IsaacLab/source/isaaclab/setup.py , modified flatdict and add setuptools

# Minimum dependencies required prior to installation
INSTALL_REQUIRES = [
    # generic
    "setuptools==81",
    "flatdict==4.1.0",
    ...
]

and installed only rsl_rl using the command ./isaaclab.sh --install rsl_rl.
I successfully ran the Ant example, but the conflicts remain.

isaacsim-kernel 5.1.0.0 has requirement psutil==5.9.8, but you have psutil 7.2.2.
isaaclab-rl 0.4.7 has requirement packaging<24, but you have packaging 24.0.
isaacsim-core 5.1.0.0 has requirement packaging==23.0, but you have packaging 24.0.
fastapi 0.115.7 has requirement starlette<0.46.0,>=0.40.0, but you have starlette 0.49.1.

but can't run ./isaaclab.sh -p scripts/reinforcement_learning/rsl_rl/train.py --task=Isaac-Velocity-Rough-Anymal-C-v0 --headless

[d-kleine]

In my opinion, the installation guidelines have some flaws. I will explain why:

First, you are saying that you have used Isaac Lab 2.3.2. Did you just clone the IsaacLab repo and install it from the main branch, as instructed by the installation guideline? If so, the main branch is currently ahead of Isaac Lab v3 beta, which is built for Isaac Sim 6 (currently in dev) and Python 3.12. Please check out at tag v2.3.2 for Isaac Sim 5.1 to ensure compatibility.

Second, for the pip installation, you should be able to install Isaac Lab 2.3.2 (post1) via pip install isaaclab==2.3.2.post1, see here. isaaclab 2.3.2.post1 is the current version that should work with Isaac Sim 5.1.

Let me know if this works for you.

[d-kleine]

Steps to reproduce

Follow the installation instructions from the official guide: https://isaac-sim.github.io/IsaacLab/v2.3.2/source/setup/installation/pip_installation.html

As I just see this, here is the correct link for pip installation routine for Isaac Lab:
https://isaac-sim.github.io/IsaacLab/v2.3.2/source/setup/installation/isaaclab_pip_installation.html#installing-dependencies

[ysheng777]

using Installation using Isaac Lab Pip Packages
when runing pip install isaaclab[isaacsim,all]==2.3.2 --extra-index-url https://pypi.nvidia.com
show error : ModuleNotFoundError: No module named 'pkg_resources'。

Downloading flatdict-4.0.1.tar.gz (8.3 kB) Installing build dependencies ... done Getting requirements to build wheel ... error error: subprocess-exited-with-error × Getting requirements to build wheel did not run successfully. │ exit code: 1 ╰─> [20 lines of output] Traceback (most recent call last): File "/home/xxx/miniconda3/envs/env_isaaclab_v232/lib/python3.11/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 389, in <module> main() File "/home/xxx/miniconda3/envs/env_isaaclab_v232/lib/python3.11/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 373, in main json_out["return_val"] = hook(**hook_input["kwargs"]) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/home/xxx/miniconda3/envs/env_isaaclab_v232/lib/python3.11/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 143, in get_requires_for_build_wheel return hook(config_settings) ^^^^^^^^^^^^^^^^^^^^^ File "/tmp/pip-build-env-a18oru3i/overlay/lib/python3.11/site-packages/setuptools/build_meta.py", line 333, in get_requires_for_build_wheel return self._get_build_requires(config_settings, requirements=[]) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/tmp/pip-build-env-a18oru3i/overlay/lib/python3.11/site-packages/setuptools/build_meta.py", line 301, in _get_build_requires self.run_setup() File "/tmp/pip-build-env-a18oru3i/overlay/lib/python3.11/site-packages/setuptools/build_meta.py", line 520, in run_setup super().run_setup(setup_script=setup_script) File "/tmp/pip-build-env-a18oru3i/overlay/lib/python3.11/site-packages/setuptools/build_meta.py", line 317, in run_setup exec(code, locals()) File "<string>", line 1, in <module> ModuleNotFoundError: No module named 'pkg_resources' [end of output] note: This error originates from a subprocess, and is likely not a problem with pip. ERROR: Failed to build 'flatdict' when getting requirements to build wheel

then，running：

pip install setuptools==75.8.0 wheel
pip install flatdict==4.0.1 --no-build-isolation

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

Package conflicts still persist.

# pip check
wheel 0.46.3 has requirement packaging>=24.0, but you have packaging 23.0.

However, it can run.

#Successfully ran the demo.
isaacsim 
python  scripts/reinforcement_learning/rsl_rl/train.py --task=Isaac-Ant-v0
python  scripts/reinforcement_learning/rsl_rl/train.py --task=Isaac-Velocity-Rough-Anymal-C-v0

Then, I tried again—installing IsaacLab 2.3.2.post1—and did not encounter the aforementioned issues; the installation was successful.

pip install isaaclab[isaacsim,all]==2.3.2.post1 --extra-index-url https://pypi.nvidia.com -i https://pypi.org/simple

[d-kleine]

Great! Yeah, you ran pip install flatdict==4.0.1 again instead of 4.1.0.
Glad it worked! 👍🏻