docs(examples): bump Isaac/Python version refs to Sim 6.0 / py3.12 (closes #103)#106
Merged
cagataycali merged 1 commit intoJun 18, 2026
Conversation
…loses strands-labs#103) The Isaac Sim 6.0 / Python 3.12 migration (strands-labs#101, PR strands-labs#102) bumps the package to `requires-python>=3.12` + `isaacsim>=6.0`, but several examples still pointed users at Isaac Sim 4.5 / Python 3.10, which can no longer satisfy the post-migration floor (the install failure in strands-labs#98). Updated the user-facing install directions and version pins: - examples/libero/run_isaac.py — `Requires` install line, the verification-status header, and the `is_available()` error-path install hint now reference Isaac Sim 6.0+ / Python 3.12 / the `nvcr.io/nvidia/isaac-sim:6.0` image. - examples/libero/run_isaac_agent.py — same set (status header, `--policy=groot` host requirement, `Requires` list, error-path hint). - examples/isaac_gs/README.md — the "GPU-validated" section now names the 6.0 image as the target runtime. - examples/mujoco_gs/pyproject.toml — `requires-python` bumped `>=3.10` → `>=3.12` for project-wide consistency (MuJoCo-only example; comment notes it technically runs on 3.10 but is pinned to 3.12 so every example installs in one environment). Historical "validated on 4.5" records are preserved (reframed to note 6.0 is the target and the dual-path imports work on both), and factual API-compat notes ("pre-4.5 builds", "4.5+ supported path") are left as-is, matching the convention in PR strands-labs#102 / PR strands-labs#105. The so101_curobo spots from the issue's location list are owned by strands-labs#104 / PR strands-labs#105 and intentionally left untouched here to avoid overlap. Docs/comment/config only. `hatch run lint` clean; `hatch run test` = 203 passed, 33 skipped (no new failures).
cagataycali
approved these changes
Jun 18, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
Updates the example-side Isaac Sim / Python version references to match
the Isaac Sim 6.0 / Python 3.12 migration (#101, PR #102), which bumps the
package to
requires-python>=3.12+isaacsim>=6.0.examples/libero/run_isaac.pyRequiresinstall line, verification-status header (docker tag), and theis_available()error-path install hint now reference Isaac Sim 6.0+ / Python 3.12 /nvcr.io/nvidia/isaac-sim:6.0.examples/libero/run_isaac_agent.py--policy=groothost requirement,Requireslist entry, and error-path install hint.examples/isaac_gs/README.mdnvcr.io/nvidia/isaac-sim:6.0image (Python 3.12) as the target runtime.examples/mujoco_gs/pyproject.tomlrequires-pythonbumped>=3.10→>=3.12for project-wide consistency.Diff: 4 files, +39 / −19.
Why
PR #102 (open) bumps the library to
requires-python>=3.12+isaacsim>=6.0.A user following the example docs would install Isaac Sim 4.5 / Python 3.10,
which can no longer satisfy that floor — the install failure tracked in #98.
The dual-path library code (
try: isaacsim.* / except ImportError: omni.isaac.*)still runs on 4.5 at runtime, but the package can no longer be installed on
a 3.10 / 4.5 host, so the example docs were misleading.
Design decisions
directions ("a working Isaac Sim 4.5+ install", error-path hints, the docker
tag users would pull) were bumped to 6.0 / 3.12. The historical
"validated end-to-end on 4.5" records were preserved but reframed to name
6.0 as the target runtime and note the dual-path imports keep the same
code path working on both 4.5 and 6.0.
legacy
omni.importer.urdffor pre-4.5 builds" and "isaacsim.storage.native… (Isaac Sim 4.5+ supported path)" are accurate statements about when a
module path became available; they remain true on 6.0 and were not rewritten.
This matches the convention stated in PR feat(isaac): migrate omni.isaac.* → isaacsim.* for Isaac Sim 6.0 / Python 3.12 (closes #101) #102 / PR docs(examples): bump so101_curobo Isaac pins to Sim 6.0 / Python 3.12 (closes #104) #105.
mujoco_gs/pyproject.toml→>=3.12. This is a MuJoCo-only example(depends on
strands-robots[sim-mujoco], notstrands-robots-sim[isaac]),so it technically runs on 3.10+. Pinned to
>=3.12for consistency with theproject-wide floor so every example installs in a single 3.12 environment; a
comment in the file documents this rationale.
What was intentionally left out (no overlap with #104 / PR #105)
The issue's location list includes two
so101_curobospots(
examples/so101_curobo/scene.py,examples/so101_curobo/requirements.txt).Those are owned by #104 / PR #105 (which is open and already bumps them),
so they are intentionally untouched here to avoid a merge collision. PR #105's
body explicitly hands the rest of the sweep to #103.
Test surface
hatch run lint— clean (black + isort + flake8 overstrands_robots_sim+examples).hatch run test— 203 passed, 33 skipped (skips are GPU/Isaac-gated). Nonew failures. Changes are docs/comment/config only, so no test behavior is
affected. (The pre-existing environmental skips/failures in
test_rendering.py/test_policy_runner.pyfrom missing X11/OpenGL on thedev box were not triggered by this run and are unrelated to this change.)
Acceptance criteria (issue #103)
examples/libero/run_isaac.pydocstring docker tag → 6.0 / py3.12examples/libero/run_isaac_agent.pydocstring docker tag → 6.0 / py3.12examples/isaac_gs/README.mdIsaac Sim 4.5 reference → 6.0 / py3.12examples/so101_curobo/scene.pyerror message — owned by PR docs(examples): bump so101_curobo Isaac pins to Sim 6.0 / Python 3.12 (closes #104) #105examples/so101_curobo/requirements.txtdocker tag — owned by PR docs(examples): bump so101_curobo Isaac pins to Sim 6.0 / Python 3.12 (closes #104) #105examples/mujoco_gs/pyproject.toml>=3.10— decided: bumped to>=3.12for consistency (MuJoCo-only; rationale in inline comment)
Out of scope / follow-ups
so101_curobospots.create_world → … → destroysmoke) requires a 6.0 GPU host (none in thisenv); this PR is scoped to the version-reference inconsistency, not a runtime
API regression. Tracked alongside R26: Validate examples/libero/run_isaac.py + run_isaac_agent.py end-to-end on the Isaac Sim backend (and fix) #73.
the example pins here are consistent with where feat(isaac): migrate omni.isaac.* → isaacsim.* for Isaac Sim 6.0 / Python 3.12 (closes #101) #102 takes the package and
are safe to land independently.
Project board
This issue is on the
Strands Labs - Robots board;
please move it to In review.
Closes #103.