NVIDIA / NVIDIA/IsaacTeleop

"No hardware" examples still need a running OpenXR runtime, and no page says to start one

Open
#892 0 comments 0 reactions 1 assignee View on GitHub

@nv-jakob is already working on this.

Since Aug 4, 2026.

Dominant language
Python
Stars
385
Forks
88
Avg merge
3d 23h
Merged PRs (30d)
82

Description

Found during internal QA of the 1.4 release.

Several examples are documented as running without hardware, but they still open an OpenXR session, and that needs a runtime running — a separate thing from having a headset attached. With no runtime up, xrCreateInstance returns -51 (XR_ERROR_RUNTIME_UNAVAILABLE) and the example dies before it does anything. None of the affected pages carry a step that starts one.

Affected as reported

The joint-space page is the sharper case: on that same page the probe modes and the MCAP replay path are explicitly annotated "no OpenXR runtime needed". Against that wording, an unqualified "no hardware" reads as "no runtime either", which is precisely the wrong inference.

One correction to the original QA note

NV_CXR_RUNTIME_DIR is not normally something a user has to set. src/core/oxr/cpp/oxr_session.cpp L66-67 defaults it to ~/.cloudxr/run, which matches the standard install layout; it only needs overriding when the runtime lives elsewhere, as in the NGC runtime image where it is /openxr/run. So the gap to close is the "start a runtime first" step, plus a note on when the run directory has to be pointed somewhere else — not an undocumented mandatory environment variable.

Suggested fix

We should hooked up all the examples with CloudXRLauncher (via Python), or better: make a Rig (https://nvidia.github.io/IsaacTeleop/main/references/rig.html) for them. (#888 CloudXRLauncher and RigLauncher still needs to be deduped).

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.