NVIDIA / NVIDIA/IsaacTeleop

Televiz Quick Start snippet imports `cupy`, which is never listed as a prerequisite

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

@farbod-nv 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.

The Televiz Quick Start tells you to install with pip install isaacteleop, and then the first runnable snippet on the same page opens with import cupy as cp. cupy is not a dependency of the wheel and is never listed as a prerequisite, so the snippet fails on a clean environment with ModuleNotFoundError: No module named 'cupy'. It runs once cupy is installed by hand.

Where

Why it fails

cupy appears in no dependency list in pyproject.toml — not in [project] dependencies (numpy, pyyaml) and not in any extra (dev, ui, retargeters, retargeters-lite, grounding, cloudxr). Verified identical on main and release/1.4.x.

Suggested fix

Either list cupy as a prerequisite ahead of the snippet — with the CUDA-matched package name, e.g. cupy-cuda12x, since a bare pip install cupy is not what most people want — or rewrite the snippet against a VizBuffer / NumPy path so the Quick Start runs on a bare pip install isaacteleop. The page already notes that any __cuda_array_interface__ producer works (CuPy / PyTorch / Numba), so CuPy is illustrative here rather than required, which argues for the second option.

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.