Skip to content

Commit 69e8707

Browse files
committed
fix hf CLI install using pipx instead of --break-system-packages
The hf binary installed in Isaac Sim's Python couldn't find 'requests' because Isaac Sim bundles it in a zip only accessible via python.sh. Use pipx to install hf into an isolated venv so all deps are available, without touching system Python packages.
1 parent baa4414 commit 69e8707

File tree

1 file changed

+6
-11
lines changed

1 file changed

+6
-11
lines changed

docker/Dockerfile.isaaclab_arena

Lines changed: 6 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -79,17 +79,12 @@ RUN /isaac-sim/python.sh -m pip install --upgrade pip && \
7979
# Lightwheel server
8080
ENV LW_API_ENDPOINT="https://api-dev.lightwheel.net"
8181

82-
# HuggingFace for downloading datasets and models.
83-
# NOTE(alexmillane, 2025-10-28): For some reason the CLI has issues when installed
84-
# in the IsaacSim version of python.
85-
RUN /isaac-sim/python.sh -m pip install huggingface-hub[cli]
86-
# This is a bit of a hack. When trying to run the Isaac Sim version of huggingface hub,
87-
# the binary can't find the dependencies, because it checks the system python. So here
88-
# we just also install huggingface hub in the system python, to get the deps.
89-
# NOTE(alexmillane, 2026-03-10): Find a nicer way of doing this.
90-
RUN python3 -m pip install --break-system-packages huggingface-hub[cli]
91-
# Create alias for hf command to use the system-installed version
92-
RUN echo "alias hf='/isaac-sim/kit/python/bin/hf'" >> /etc/bash.bashrc
82+
# HuggingFace CLI for downloading datasets and models.
83+
# Use pipx so the hf binary gets an isolated venv with all its deps (e.g. requests),
84+
# without touching system Python packages.
85+
# PIPX_BIN_DIR=/usr/local/bin puts hf on PATH for all users.
86+
RUN apt-get install -y pipx && \
87+
PIPX_HOME=/opt/pipx PIPX_BIN_DIR=/usr/local/bin pipx install "huggingface-hub[cli]"
9388

9489
###############################
9590
# Install GR00T and CUDA 12.8 #

0 commit comments

Comments
 (0)