Removes modular installation commands from docs#5021
Removes modular installation commands from docs#5021kellyguo11 wants to merge 7 commits intoisaac-sim:developfrom
Conversation
Greptile SummaryThis PR cleans up Isaac Lab documentation by removing modular/partial installation commands that are not yet fully functional, simplifying the install story to the recommended full-bundle path. Key changes:
The first two files are clean improvements. The quickstart change warrants a second look: now that Isaac Sim is framed as optional, the guide no longer tells users who skip Isaac Sim how to obtain a CUDA-enabled PyTorch build, which every RL framework depends on. Confidence Score: 4/5
Important Files Changed
Flowchart%%{init: {'theme': 'neutral'}}%%
flowchart TD
A[Create virtual environment] --> B[Update pip]
B --> C{Install Isaac Sim?\nOptional}
C -- Yes --> D["uv pip install isaacsim[all,extscache]"]
C -- No --> E["⚠️ PyTorch not installed\n(no longer documented here)"]
D --> F[Clone Isaac Lab repo]
E --> F
F --> G["./isaaclab.sh --install\n(installs all sub-packages)"]
G --> H[Run training scripts]
subgraph pip_path["Pip Package Path (isaaclab_pip_installation.rst)"]
P1["uv pip install 'isaaclab[isaacsim,all]'"] --> P2[Install PyTorch CUDA]
P2 --> P3[Run user scripts]
end
Last reviewed commit: 1cfb752 |
| uv pip install --upgrade pip | ||
|
|
||
| and now we can install the Isaac Sim packages. | ||
| and now we can install the Isaac Sim packages (Optional). |
There was a problem hiding this comment.
Missing PyTorch install step after making Isaac Sim optional
Before this PR the Isaac Sim install was unconditional, so PyTorch was always pulled in as a dependency. Now that the line reads "(Optional)", a user who skips the Isaac Sim step will find no instruction to install PyTorch anywhere in this guide — yet every RL framework (rl_games, rsl_rl, skrl, etc.) requires it.
The PR also removed the explicit CUDA-enabled PyTorch install command that used to appear just before this section:
uv pip install -U torch==2.10.0 torchvision==0.25.0 --index-url https://download.pytorch.org/whl/cu128If the intent is that ./isaaclab.sh --install handles PyTorch automatically (or that users can rely on Isaac Sim bringing it in), it would be worth adding a short note here. For example:
| and now we can install the Isaac Sim packages (Optional). | |
| and now we can install the Isaac Sim packages (Optional). If you skip this step, install | |
| a CUDA-enabled PyTorch build manually before running ``isaaclab.sh --install`` | |
| (see the :ref:`pip-installation` guide for the recommended command). |
Without any such guidance, users on the Newton-only kitless path who still want to use RL frameworks will hit confusing import errors.
Description
Updates documentation to clean up modular installation commands as they are not fully functional yet.
Type of change
Checklist
pre-commitchecks with./isaaclab.sh --formatconfig/extension.tomlfileCONTRIBUTORS.mdor my name already exists there