[Bug Report] Pip install IsaacLab 2.3.0 is broken for ubuntu + uv

[KyleM73]

2.3.0 bumps IsaacSim to 5.1.0 but IsaacSim 5.1.0 has poorly behaved dependencies, specifically for pywin32. When trying to pip install IsaacLab on ubuntu via uv pip install isaaclab[isaacsim] the dependency fails to resolve with

error: Distribution `pywin32==306 @ registry+https://pypi.org/simple` can't be installed because it doesn't have a source distribution or wheel for the current platform

hint: You're on Linux (`manylinux_2_35_x86_64`), but `pywin32` (v306) only has wheels for the following platforms: `win32`, `win_amd64`, `win_arm64`; consider adding your platform to `tool.uv.required-environments` to ensure uv resolves to a version with compatible wheels

@kellyguo11 for visibility

Checklist

• I have checked that there is no similar issue in the repo (required)
• I have checked that the issue is not in running Isaac Sim itself and is related to the repo

Acceptance Criteria

Add the criteria for which this task is considered done. If not known at issue creation time, you can add this once the issue is assigned.

• uv pip install from ubuntu is successful

[garylvov]

I experience a similar problem when installing on Pixi as well.

[RandomOakForest]

Thank you for catching this. The team will update as needed.

[kellyguo11]

This seems to be a more fundamental issue with how the Kit-based packages are set up. Currently, the linux and windows dependencies are specified together as a placeholder package, which is causing windows packages to also be pulled on linux, leading to errors. We will have to work with the Omniverse team to see how we can best handle the dependencies across platforms separately.

[garylvov]

Here is my error output with Pixi on Ubuntu 24 in case it helps with troubleshooting (I now realize I have a slightly different error):

garylvov@minerva:~/projects/gigastrap$ pixi update
Error:   × failed to solve the pypi requirements of environment 'gsn' for platform 'linux-64'
  ├─▶ failed to resolve pypi dependencies
  ╰─▶ Because isaacsim[all]==5.0.0.0 has no wheels with a matching platform tag (e.g.,
      `manylinux_2_28_x86_64`) and you require isaacsim[all]==5.0.0, we can conclude
      that your requirements are unsatisfiable.
      
      hint: Wheels are available for `isaacsim` (v5.0.0.0) on the following platforms:
      `manylinux_2_35_x86_64`, `win_amd64`

garylvov@minerva:~/projects/gigastrap$ 

In my manifest, I put

[feature.isaaclab.pypi-dependencies]
isaacsim = { version = "==5.0.0", index = "https://pypi.nvidia.com", extras = ["all", "extcache"] }

EDIT: On the install site, it mentions that:

"Installing Isaac Sim with pip requires GLIBC 2.35+ version compatibility. To check the GLIBC version on your system, use command ldd --version. This may pose compatibility issues with some Linux distributions. For instance, Ubuntu 20.04 LTS has GLIBC 2.31 by default. If you encounter compatibility issues, we recommend following the Isaac Sim Binaries Installation approach."

However, I'm still experiencing the issue, and I'm on Ubuntu 24 with GLIBC 2.39

(gigastrap:gsi) garylvov@minerva:~/projects/gigastrap$ ldd --version
ldd (Ubuntu GLIBC 2.39-0ubuntu8.6) 2.39
Copyright (C) 2024 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Written by Roland McGrath and Ulrich Drepper.
(gigastrap:gsi) garylvov@minerva:~/projects/gigastrap$ 

If I just raw pip install within my pixi env with

pip install 'isaacsim[all,extscache]==5.0.0' --extra-index-url https://pypi.nvidia.com

it works, so some weird stuff going on here.

EDIT ONCE AGAIN: I also tried with 5.1.0, and recieved:

Error:   × failed to solve the pypi requirements of environment 'gsn' for platform 'linux-64'
  ├─▶ failed to resolve pypi dependencies
  ╰─▶ Because isaacsim[all]==5.1.0.0 has no wheels with a matching platform tag (e.g., `manylinux_2_28_x86_64`) and you require isaacsim[all]==5.1.0, we can
      conclude that your requirements are unsatisfiable.
      
      hint: Wheels are available for `isaacsim` (v5.1.0.0) on the following platforms: `manylinux_2_35_aarch64`, `manylinux_2_35_x86_64`, `win_amd64`

(gigastrap:gsi) garylvov@minerva:~/projects/gigastrap$ 

I'd be happy to open another issue for Pixi specifically if my pixi issues and @KyleM73 's UV issues are unrelated, but I suspect some relation

[DBinK]

I have this problem when using uv sync and uv pip install , but the installation is successful using pip

$ uv sync 

Resolved 145 packages in 1.09s
error: Distribution `pywin32==306 @ registry+https://pypi.tuna.tsinghua.edu.cn/simple` can't be installed because it doesn't have a source distribution or wheel for the current platform

hint: You're on Linux (`manylinux_2_35_x86_64`), but `pywin32` (v306) only has wheels for the following platforms: `win32`, `win_amd64`, `win_arm64`; consider adding your platform to `tool.uv.required-environments` to ensure uv resolves to a version with compatible wheels'

$ uv pip install "isaacsim[all,extscache]==5.1.0"

  × No solution found when resolving dependencies:
  ╰─▶ Because pywin32==306 has no wheels with a matching platform tag (e.g., `manylinux_2_35_x86_64`)
      and isaacsim-core==5.1.0.0 depends on pywin32==306, we can conclude that isaacsim-core==5.1.0.0
      cannot be used.
      And because isaacsim[all]==5.1.0.0 depends on isaacsim-core==5.1.0.0 and you require
      isaacsim[all]==5.1.0, we can conclude that your requirements are unsatisfiable.

      hint: Wheels are available for `pywin32` (v306) on the following platforms: `win32`, `win_amd64`,
      `win_arm64`

my pyproject.toml:

[project]
name = "isaac-xr"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
requires-python = ">=3.11"
dependencies = [
    "isaacsim[all,extscache]==5.1.0",
    "torch==2.7.0",
    "torchvision==0.22.0",
]
[tool.uv.sources]
torch = [{ index = "pytorch-cu128" }]
torchvision = [{ index = "pytorch-cu128" }]
isaaclab = [{ index = "isaac" }]
isaacsim = [{ index = "isaac" }]

[[tool.uv.index]]
name = "pytorch-cu128"
url = "https://download.pytorch.org/whl/cu128"
explicit = true

[[tool.uv.index]]
name = "isaac"
url = "https://pypi.nvidia.com"
explicit = true

[AtticusZeller]

it works for me by overriding pywin32==306; sys_platform == 'win32'
repo-IsaacLab-uv

[project]
name = "isaaclab-uv"
description = "isaaclab template with uv"
readme = "README.md"
requires-python = ">=3.11,<3.12"
license = { file = "LICENSE" }
dynamic = ["version"] # https://hatch.pypa.io/latest/config/metadata/#version
dependencies = [
    "isaacsim[all,extscache]==5.1.0.0", # https://isaac-sim.github.io/IsaacLab/main/source/setup/installation/pip_installation.html#installing-dependencies
    "torch==2.7.0",
    "torchvision==0.22.0",
    "isaaclab",
    "isaaclab-assets",
    "isaaclab-mimic",
    "isaaclab-rl",
    "isaaclab-tasks",
]

[project.optional-dependencies]
rl = ["isaaclab-mimic[all]", "isaaclab-rl[all]"]
# optional deps for package installation

[dependency-groups]


[tool.uv]
environments = [
    "sys_platform == 'linux'",
] # https://docs.astral.sh/uv/concepts/projects/config/#limited-resolution-environments
override-dependencies = ["pywin32==306; sys_platform == 'win32'"]
# FIX: https://github.com/isaac-sim/IsaacLab/issues/3884
# 1. https://docs.astral.sh/uv/reference/settings/#override-dependencies
# 2. https://docs.astral.sh/uv/concepts/projects/dependencies/#platform-specific-dependencies

[tool.uv.sources]
# pip install torch==2.7.0 torchvision==0.22.0 --index-url https://download.pytorch.org/whl/cu128
torch       = [{ index = "pytorch-cu128" }]
torchvision = [{ index = "pytorch-cu128" }]
# pip install "isaacsim[all,extscache]==5.1.0.0" --extra-index-url https://pypi.nvidia.com
isaacsim        = [{ index = "nvidia" }]
isaaclab        = { path = "isaaclab/source/isaaclab", editable = true }
isaaclab-assets = { path = "isaaclab/source/isaaclab_assets", editable = true }
isaaclab-tasks  = { path = "isaaclab/source/isaaclab_tasks", editable = true }
isaaclab-rl     = { path = "isaaclab/source/isaaclab_rl", editable = true }
isaaclab-mimic  = { path = "isaaclab/source/isaaclab_mimic", editable = true }

[[tool.uv.index]]
name     = "pytorch-cu128"
url      = "https://download.pytorch.org/whl/cu128"
explicit = true

[[tool.uv.index]]
name     = "nvidia"
url      = "https://pypi.nvidia.com"
explicit = true

[cidxb]

This seems to be a more fundamental issue with how the Kit-based packages are set up. Currently, the linux and windows dependencies are specified together as a placeholder package, which is causing windows packages to also be pulled on linux, leading to errors. We will have to work with the Omniverse team to see how we can best handle the dependencies across platforms separately.

So basically, the safest way is to install via the sh file, right?

[garylvov]

My issue with libc on Pixi was resolved via adding the following lines to my manifest.
Sorry for polluting the UV issue with crosstalk on with a Pixi issue; posting for posterity.

[system-requirements]
libc = { family = "glibc", version = 2.35 }

EDIT: That ended up being the tip of the iceberg, but there still exists a workaround for Pixi.

There seems to be conflicting dependency requirements in the metadata of the isaac packages themselves, that require pypi-options.dependency-overrides to work.

I also had this, but unsure if it's really needed.

garylvov@minerva:~/projects/gigastrap$ cat pixi.toml | grep map
conda-pypi-map = { "https://prefix.dev/conda-forge" = "conda_pypi_mapping.json" }
garylvov@minerva:~/projects/gigastrap$ cat conda_pypi_mapping.json 
{
  "pywin32": "pywin32"
}
garylvov@minerva:~/projects/gigastrap$ 

Since pixi pins conda packages relative to pypi packages, I made this messy script to amend the manifest to get the needed conda versions so that pypi/uv install of isaac doesn't complain. This script also amends the pypi-options.dependency-overrides

I also added a pywin32 dep from conda and an override despite being on linux.

I get the following from my script, adding the libc, and adding the pywin thing.

[feature.isaaclab]
[feature.isaaclab.dependencies]
cmake = ">3.6"
# Pin versions required by isaacsim-kernel to override conda's defaults
requests = "==2.32.3"
psutil = "==5.9.8"
propcache = "==0.2.1"
aiohappyeyeballs = "==2.4.4"
pytz = "==2024.1"
frozenlist = "==1.5.0"
charset-normalizer = "==3.3.2"
watchdog = "==4.0.0"
aiosignal = "==1.3.2"
coverage = "==7.4.4"
typing-extensions = "==4.12.2"
idna = "==3.10"
yarl= "==1.18.3"
multidict = "==6.1.0"
attrs = "==25.1.0"
click = "==8.1.7"
aiohttp = "==3.11.11"
sympy = "==1.13.3"
networkx = "==3.3"
# mujoco moved to [feature.gpu.pypi-dependencies] to avoid libabseil conflict
fsspec = "==2024.6.1"
filelock = "==3.13.1"
cryptography = "==44.0.0"
pyyaml = "==6.0.2"
tornado = "==6.5.1"
packaging = "==23.0"
kiwisolver = "==1.4.4"
cycler = "==0.11.0"
pyparsing = "==3.0.9"
fonttools = "==4.55.3"
contourpy = "==1.3.1"
matplotlib = "==3.10.3"
markupsafe = "==2.1.3"
nest-asyncio = "==1.5.6"
# Conda pywin32 stub satisfies isaacsim's pywin32 requirement on Linux
pywin32 = ">=306"


[feature.isaaclab.system-requirements]
libc = {family = "glibc", version = "2.35"}

[feature.isaaclab.pypi-options.dependency-overrides]
numpy = "==1.26.4"
torch = "==2.7.1"
pillow = "==12.0.0"
scipy = "==1.16.3"
pywin32 = "*"
triton = "==3.3.0"
[feature.isaaclab.pypi-dependencies]
isaacsim = { version = "==5.1.0", index = "https://pypi.nvidia.com", extras = ["all", "extscache"] }
# Explicitly add extcache packages since pixi/uv doesn't resolve the extras correctly
scipy = "==1.16.3"