[Bug Report] Cannot install IsaacLab with uv

[PabloVD]

I'm following the IsaacLab installation instructions building it from source using uv from the documentation, but it raises the following error. I'm using Ubuntu 22.

     Build targets in project: 100
      WARNING: Project specifies a minimum meson_version '>=1.2.99' but uses features which were added in newer versions:
       * 1.3.0: {'dep 'blas' custom lookup', 'dep 'lapack' custom lookup'}

      NumPy 1.26.4

        User defined options
          Native files: /home/tda/.cache/uv/sdists-v9/pypi/numpy/1.26.4/VbLTxVdsH1TK70hFaVj86/src/.mesonpy-1lf6nsl5/meson-python-native-file.ini
          buildtype   : release
          b_ndebug    : if-release
          b_vscrt     : md

      Found ninja-1.10.1 at /usr/bin/ninja

      [stderr]
      Traceback (most recent call last):
        File "/home/tda/.cache/uv/builds-v0/.tmpfqM4uA/lib/python3.13/site-packages/pyproject_metadata/__init__.py", line 515, in validate
          packaging.utils.canonicalize_name(self.name, validate=True)
          ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^
      TypeError: canonicalize_name() got an unexpected keyword argument 'validate'

      During handling of the above exception, another exception occurred:

      Traceback (most recent call last):
        File "<string>", line 11, in <module>
          wheel_filename = backend.build_wheel("/home/tda/.cache/uv/builds-v0/.tmp26dQol", {}, None)
        File "/home/tda/.cache/uv/builds-v0/.tmpfqM4uA/lib/python3.13/site-packages/mesonpy/__init__.py", line 985, in wrapper
          return func(*args, **kwargs)
        File "/home/tda/.cache/uv/builds-v0/.tmpfqM4uA/lib/python3.13/site-packages/mesonpy/__init__.py", line 1038, in build_wheel
          with _project(config_settings) as project:
               ~~~~~~~~^^^^^^^^^^^^^^^^^
        File "/home/tda/.local/share/uv/python/cpython-3.13.1-linux-x86_64-gnu/lib/python3.13/contextlib.py", line 141, in __enter__
          return next(self.gen)
        File "/home/tda/.cache/uv/builds-v0/.tmpfqM4uA/lib/python3.13/site-packages/mesonpy/__init__.py", line 912, in _project
          yield Project(source_dir, build_dir, meson_args, editable_verbose)
                ~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "/home/tda/.cache/uv/builds-v0/.tmpfqM4uA/lib/python3.13/site-packages/mesonpy/__init__.py", line 693, in __init__
          self._metadata = Metadata.from_pyproject(pyproject, self._source_dir)
                           ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "/home/tda/.cache/uv/builds-v0/.tmpfqM4uA/lib/python3.13/site-packages/mesonpy/__init__.py", line 230, in from_pyproject
          metadata = super().from_pyproject(data, project_dir)
        File "/home/tda/.cache/uv/builds-v0/.tmpfqM4uA/lib/python3.13/site-packages/pyproject_metadata/__init__.py", line 428, in from_pyproject
          self = cls(
              name=name,
          ...<36 lines>...
              all_errors=all_errors,
          )
        File "/home/tda/.cache/uv/builds-v0/.tmpfqM4uA/lib/python3.13/site-packages/mesonpy/__init__.py", line 211, in __init__
          super().__init__(name, *args, **kwargs)
          ~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^
        File "<string>", line 24, in __init__
        File "/home/tda/.cache/uv/builds-v0/.tmpfqM4uA/lib/python3.13/site-packages/pyproject_metadata/__init__.py", line 293, in __post_init__
          self.validate()
          ~~~~~~~~~~~~~^^
        File "/home/tda/.cache/uv/builds-v0/.tmpfqM4uA/lib/python3.13/site-packages/pyproject_metadata/__init__.py", line 516, in validate
          except packaging.utils.InvalidName:
                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
      AttributeError: module 'packaging.utils' has no attribute 'InvalidName'

      hint: This usually indicates a problem with the package or the build environment.
  help: `numpy` (v1.26.4) was included because `isaaclab-tasks` (v0.11.0) depends on `numpy`
[INFO] Installing extra requirements such as learning frameworks...
[INFO] Installing all rl-frameworks...
Using Python 3.13.1 environment at: env_isaaclab
Resolved 105 packages in 1.41s
  × Failed to build `ml-dtypes==0.4.1`
  ├─▶ The build backend returned an error
  ╰─▶ Call to `setuptools.build_meta.build_wheel` failed (exit status: 1)

      [stderr]
      Traceback (most recent call last):
        File "/home/tda/ngc/IsaacLab/_isaac_sim/extscache/omni.kit.pip_archive-0.0.0+8131b85d.lx64.cp311/pip_prebundle/numpy/core/__init__.py", line 24,
      in <module>
          from . import multiarray
        File "/home/tda/ngc/IsaacLab/_isaac_sim/extscache/omni.kit.pip_archive-0.0.0+8131b85d.lx64.cp311/pip_prebundle/numpy/core/multiarray.py", line 10,
      in <module>
          from . import overrides
        File "/home/tda/ngc/IsaacLab/_isaac_sim/extscache/omni.kit.pip_archive-0.0.0+8131b85d.lx64.cp311/pip_prebundle/numpy/core/overrides.py", line 8,
      in <module>
          from numpy.core._multiarray_umath import (
              add_docstring,  _get_implementing_args, _ArrayFunctionDispatcher)
      ModuleNotFoundError: No module named 'numpy.core._multiarray_umath'

      During handling of the above exception, another exception occurred:

      Traceback (most recent call last):
        File "/home/tda/ngc/IsaacLab/_isaac_sim/extscache/omni.kit.pip_archive-0.0.0+8131b85d.lx64.cp311/pip_prebundle/numpy/__init__.py", line 130, in
      <module>
          from numpy.__config__ import show as show_config
        File "/home/tda/ngc/IsaacLab/_isaac_sim/extscache/omni.kit.pip_archive-0.0.0+8131b85d.lx64.cp311/pip_prebundle/numpy/__config__.py", line 4, in
      <module>
          from numpy.core._multiarray_umath import (
          ...<3 lines>...
          )
        File "/home/tda/ngc/IsaacLab/_isaac_sim/extscache/omni.kit.pip_archive-0.0.0+8131b85d.lx64.cp311/pip_prebundle/numpy/core/__init__.py", line 50,
      in <module>
          raise ImportError(msg)
      ImportError:

      IMPORTANT: PLEASE READ THIS FOR ADVICE ON HOW TO SOLVE THIS ISSUE!

      Importing the numpy C-extensions failed. This error can happen for
      many reasons, often due to issues with your setup or how NumPy was
      installed.

      We have compiled some common reasons and troubleshooting tips at:

          https://numpy.org/devdocs/user/troubleshooting-importerror.html

      Please note and check the following:

        * The Python version is: Python3.13 from "/home/tda/.cache/uv/builds-v0/.tmpUlfN89/bin/python"
        * The NumPy version is: "1.26.0"

      and make sure that they are the versions you expect.
      Please carefully study the documentation linked above for further help.

      Original error was: No module named 'numpy.core._multiarray_umath'


      The above exception was the direct cause of the following exception:

      Traceback (most recent call last):
        File "<string>", line 14, in <module>
          requires = get_requires_for_build({})
        File "/home/tda/.cache/uv/builds-v0/.tmpUlfN89/lib/python3.13/site-packages/setuptools/build_meta.py", line 355, in get_requires_for_build_wheel
          return self._get_build_requires(config_settings, requirements=['wheel'])
                 ~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "/home/tda/.cache/uv/builds-v0/.tmpUlfN89/lib/python3.13/site-packages/setuptools/build_meta.py", line 325, in _get_build_requires
          self.run_setup()
          ~~~~~~~~~~~~~~^^
        File "/home/tda/.cache/uv/builds-v0/.tmpUlfN89/lib/python3.13/site-packages/setuptools/build_meta.py", line 341, in run_setup
          exec(code, locals())
          ~~~~^^^^^^^^^^^^^^^^
        File "<string>", line 19, in <module>
          json.dump(requires, fp)
          ^^^^^^^^^^^^^^
        File "/home/tda/ngc/IsaacLab/_isaac_sim/extscache/omni.kit.pip_archive-0.0.0+8131b85d.lx64.cp311/pip_prebundle/numpy/__init__.py", line 135, in
      <module>
          raise ImportError(msg) from e
      ImportError: Error importing numpy: you should not try to import numpy from
              its source directory; please exit the numpy source tree, and relaunch
              your python interpreter from there.

      hint: This usually indicates a problem with the package or the build environment.
  help: `ml-dtypes` (v0.4.1) was included because `isaaclab-rl[all]` (v0.4.1) depends on `rsl-rl-lib` (v3.0.1) which depends on `onnx` (v1.19.0) which
        depends on `ml-dtypes`

[marklang3]

I am also unable to install IsaacLab with uv

[RandomOakForest]

Thank you for posting this. The issue is likely that python 3.13 is the version landing on your env with the uv option. This seems to be something overlooked in the isaaclab.sh script. We will fix this. To have more control and build right away, try using conda. Use #3021 for installation steps.

[kellyguo11]

@KyleM73 did you happen to hit these issues with uv installation?

[kwang-12]

I also run into the same problem.
#3560 addresses this directly. it's a simple fix in the isaac.sh.
@RandomOakForest please consider merging the PR.

[KyleM73]

@KyleM73 did you happen to hit these issues with uv installation?

I hadn't until recently- uv isn't always picking up the correct version of python. Currently very easy "fix" is just to specify which python version (fixes this issue for me on multiple machines both IsaacSim 4.5 and 5.0) but of course we want the script to do that automatically. Specifically, the line in isaaclab.sh can be (hardcoded)
uv venv --clear --python 3.11 "${env_path}". I'm not sure why the python path wasn't being resolved correctly- I'll look at the PR and see if that works for me to make sure the correct version is being picked up.

[PabloVD]

I tried again in a fresh new project and it worked fine, I could install IsaacLab with uv. I created a uv project with a .venv, ran ./isaaclab --uv ../.venvand then ./isaaclab -i.

However the vscode settings were not set:

[INFO] Setting up vscode settings...
[WARN] Could not find Isaac Sim VSCode settings: /home/tda/ngc/isaac_bsk/.venv/lib/python3.11/site-packages/isaacsim/.vscode/settings.json.
    This will result in missing 'python.analysis.extraPaths' in the VSCode
    settings, which limits the functionality of the Python language server.
    However, it does not affect the functionality of the Isaac Lab project.
    We are working on a fix for this issue with the Isaac Sim team.