Preserve GR00T dependency pins during rollout

[jaybdub]

Description

Documents GR00T N1.5's compatible NumPy, PyArrow, Numpydantic, and Pydantic pins and launches dataset conversion and rollout with uv run --no-sync. This prevents the Isaac Lab workspace sync from replacing GR00T's versions before policy import.

Tracks NVBug 6682951.

Type of change

• Bug fix
• Documentation update

Release backport

• Backport this pull request to the active release branch after it merges into develop

Validation

• Reproduced both reported failures inside headless Isaac Sim 6.0.1: PyArrow AttributeError: _ARRAY_API not found and Numpydantic/Pydantic InvalidSchemaError.
• Verified the actual Isaac Lab GR00T policy module imports with the documented pins and uv run --no-sync.
• Verified the dataset conversion CLI starts with the same pinned environment and --no-sync.
• uv run --isolated --extra test -- make -C docs current-docs
• uv run isaaclab -f

Screenshots

Not applicable.

Checklist

• I have read and understood the contribution guidelines.
• I have run the pre-commit checks.
• I have made the corresponding documentation change.
• My changes generate no new warnings.
• I have run a fail-before/pass-after simulator regression check.
• Changelog fragment is not applicable to this docs-only change.
• The contributor already appears in repository revision history.

[greptile-apps]

Confidence Score: 4/5

The PR should not merge until the documented workflow preserves the GR00T pins across the intervening dataset-conversion commands.

Findings

1.  Later Sync Replaces Pins ▶

Summary

• Pins compatible NumPy, PyArrow, Numpydantic, and Pydantic versions.
• Explains the failures caused by replacing those versions.
• Launches rollout with uv run --no-sync.
• Still contains intervening synchronizing commands that can replace the pins before rollout.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[Install GR00T-compatible pins] --> B[Dataset conversion via regular uv run]
  B --> C[Isaac Lab workspace synchronization]
  C --> D[GR00T pins replaced by workspace versions]
  D --> E[Rollout via uv run --no-sync]
  E --> F[Already-replaced versions are preserved]
  F --> G[Policy import can still fail]

Loading

[isaaclab-review-bot]

Isaac Lab Review Bot

The documented GR00T dependency pins and uv run --no-sync rollout command address the reported compatibility failures, but the workflow still includes plain uv run conversion commands that can overwrite those pins before rollout.

• Design and architecture: Pinning GR00T N1.5’s compatible dependency versions and preventing an Isaac Lab workspace sync during rollout fits the documented shared-environment workflow. However, that preservation strategy must cover every subsequent Isaac Lab-root command that can synchronize the same environment.
• API: No source-level public API changes are introduced. The user-facing CLI contract changes only by adding --no-sync to the documented rollout invocation; the rollout script’s arguments remain unchanged.
• Implementation: The conversion commands at lines 687 and 695 still use plain uv run after the pins are installed. According to the newly added warning, those commands can synchronize the Isaac Lab workspace and replace GR00T’s versions, while the later rollout’s --no-sync merely preserves the already-modified environment. Apply --no-sync to those post-install conversion commands or install the compatibility pins after the final synchronizing command.

Minor fixes needed. Posted 1 actionable finding inline.

Automated review; human maintainers own approval decisions.

[kellyguo11]

run-ci

[kellyguo11]

run-ci

[isaaclab-bot]

Backported to release/3.0.0 as bee8c70.