setup-isaac

Create a Python 3.11 virtual environment with NVIDIA Isaac Sim dependencies.

Updated Sep 9, 2024
One-click install
npx skills add https://github.com/axel-kaliff/dotfiles --skill setup-isaac
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-isaac
Source: https://github.com/axel-kaliff/dotfiles/tree/main/claude/.claude/skills/setup-isaac
Command: npx skills add https://github.com/axel-kaliff/dotfiles --skill setup-isaac

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sets up a reproducible Python 3.11 virtual environment configured with NVIDIA Isaac Sim and project dependencies for RTX ray tracing and path tracing so users can run Isaac Sim renderer workflows and isaac_sim smoke tests locally or in CI.

Core Features & Use Cases

  • Automated venv creation: Provision a .venv-isaac for the project's src/simulation/isaac_sim and install Isaac Sim packages via uv sync.
  • Preflight checks: Validate Python 3.11 availability, detect an RTX GPU, and ensure adequate disk space (~15GB) to prevent common installation failures.
  • EULA and package sourcing: Require OMNI_KIT_ACCEPT_EULA=YES, install packages from https://pypi.nvidia.com, and pin numpy to 1.26.0 for numba compatibility.
  • Use Case: Developer or CI engineer preparing a workstation or pipeline to perform RTX rendering or run isaac_sim smoke tests.

Quick Start

Set up a Python 3.11 virtualenv for Isaac Sim with the uv sync command, ensure OMNI_KIT_ACCEPT_EULA=YES, and confirm an RTX GPU and about 15GB free disk space before running tests.

Frequently Asked Questions about setup-isaac

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Python virtual environment for NVIDIA Isaac Sim?

To set up a Python virtual environment for NVIDIA Isaac Sim, create a Python 3.11 virtualenv and use uv sync to install Isaac Sim packages from pypi.nvidia.com. You must also set OMNI_KIT_ACCEPT_EULA=YES and initialize SimulationApp before importing omni or pxr modules.

What are the prerequisites for running Isaac Sim RTX ray tracing locally?

Running Isaac Sim RTX ray tracing requires a workstation with an RTX GPU, Python 3.11, and approximately 15GB of free disk space. The environment must also pin numpy to version 1.26.0 to ensure numba compatibility during the simulation setup.

Why does my Isaac Sim installation fail due to numpy or numba compatibility issues?

Isaac Sim installation fails due to numba compatibility when numpy is not pinned to version 1.26.0. Installing project dependencies via uv sync in a Python 3.11 virtual environment resolves this by enforcing the correct package versions from pypi.nvidia.com.

Do I need an RTX GPU to run Isaac Sim smoke tests in CI?

Yes, you need an RTX GPU to run Isaac Sim smoke tests in CI because the renderer utilizes RTX ray tracing and path tracing capabilities. The setup process includes preflight checks to detect an RTX GPU and verify adequate disk space before installation.

Can I use Python 3.10 or 3.12 for Isaac Sim virtualenv configuration?

No, Isaac Sim virtualenv configuration requires Python 3.11 specifically. The setup validates Python 3.11 availability during preflight checks to ensure compatibility with NVIDIA Isaac Sim packages and the pinned numpy 1.26.0 dependency.

What environment variables do I need to accept the NVIDIA Isaac Sim EULA?

You need to set the OMNI_KIT_ACCEPT_EULA=YES environment variable to accept the NVIDIA Isaac Sim EULA. This is required before installing packages from pypi.nvidia.com and initializing the SimulationApp for RTX rendering workflows.