holoscan-install-wheel
Install Holoscan SDK 5.x CUDA 13 Python wheels in an isolated environment, choosing the full stack or version-matched components.
Install / Use
npx skills add NVIDIA/skills --skill holoscan-install-wheelInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of holoscan-install-wheel
holoscan-install-wheel scores 94/100 on our quality scale, 511th of 4,700 Development & Engineering skills we index (top 11%).
Its SKILL.md is 6.2 KB long, well organised into 20 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.
With 3,421 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so holoscan-install-wheel is actively maintained.
- Our last check on 2026-10-25 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
holoscan-install-wheel compared with similar skills
All 4 of these similar skills score higher than holoscan-install-wheel; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| holoscan-install-wheel (this skill)by NVIDIA | 94 | 3.4k | 54d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install holoscan-install-wheel?
- Run
npx skills add NVIDIA/skills --skill holoscan-install-wheel. The install tabs above show the steps for each supported agent. - Which AI agents does holoscan-install-wheel work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is holoscan-install-wheel safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is holoscan-install-wheel still maintained?
- The repository was last updated about 2 months ago, so holoscan-install-wheel is actively maintained.
Skill content
View source on GitHubname: holoscan-install-wheel version: "1.0.0" description: "Install Holoscan SDK Python wheel via pip into a venv. Use for Python installs; not for native C++/apt or Conda installs." license: Apache-2.0 metadata: author: "Holoscan Team holoscan-team@nvidia.com" github-url: "https://github.com/nvidia-holoscan/holoscan-sdk" tags: - holoscan - install - pip - wheel - python
Holoscan pip Wheel Installation
Purpose
Install the Holoscan SDK Python bindings via the holoscan-cu12 / holoscan-cu13 pip wheel into a virtual environment, and verify with hello_world and video_replayer.
Prerequisites
- Linux x86_64 with NVIDIA GPU + driver (
nvidia-smi). - CUDA Toolkit on
PATHmatching the host CUDA major (12 or 13). - Python 3.10–3.13 with
venvavailable. - Network access to PyPI and
docs.nvidia.com.
Limitations
- Python only. For C++ headers/libs, pair with
/holoscan-install-debian. holoscan-cu12andholoscan-cu13are mutually exclusive — wheel must match host CUDA driver.video_replayerdata ships only with the Debian package; without it, setHOLOSCAN_INPUT_PATHto a directory containingracerx/.ulimit -s 32768is recommended in every shell that runs Holoscan — without it some apps emit a stack-size warning or, in rarer cases, segfault.
Step 0: Consult the Official Install Instructions
Always fetch the pip-wheel section of https://docs.nvidia.com/holoscan/sdk-user-guide/sdk_installation.html before installing. Extract: exact wheel package names (holoscan-cu12, holoscan-cu13), the supported Python range for the current release, prerequisites that must be on PATH (CUDA Toolkit), and any optional extras (LibTorch / ONNX Runtime version pins). If the doc disagrees with anything below, the doc wins.
You need the CUDA variant already determined. If not known, run nvidia-smi 2>&1 | head -5 first.
CUDA variant rule — pick the pip package:
| nvidia-smi CUDA Version | pip package |
|------------------------|-------------|
| 13.x+ | holoscan-cu13 |
| 12.x (any GPU) | holoscan-cu12 |
Prerequisites: CUDA Toolkit on PATH, Python 3.10–3.13. Optional extras: LibTorch 2.11.0+, ONNX Runtime 1.22.0+.
Always install into a Python virtual environment — this avoids system-package conflicts and is required on Ubuntu 24.04 (which blocks system-wide pip entirely).
Step 1: Create and Activate the venv
Check if one exists first:
ls ~/holoscan/venv 2>/dev/null && echo "exists" || echo "missing"
If missing:
python3 -m venv ~/holoscan/venv
Then activate:
source ~/holoscan/venv/bin/activate
Step 2: Install
pip install holoscan-cu12 # or holoscan-cu13
Step 3: Verify
The venv must be active for all commands below.
# Basic import — expected: version string, e.g. "4.1.0"
# The stack-size RuntimeWarning is harmless; ulimit -s 32768 suppresses it.
python3 -c "import holoscan; print(holoscan.__version__)"
# Fetch Python examples from GitHub at the installed version tag.
# These are official NVIDIA examples, fetched over HTTPS and pinned to the tag
# matching the installed wheel (v${SDK_VER}). Before running them, tell the user
# you're about to download and execute remote example scripts from this URL. If
# they decline or GitHub is unreachable, skip to browsing the examples in Step 4.
SDK_VER=$(python3 -c "import holoscan; print(holoscan.__version__)")
BASE="https://raw.githubusercontent.com/nvidia-holoscan/holoscan-sdk/v${SDK_VER}/examples"
# hello_world — expected: "Hello World!"
curl -fsSL "${BASE}/hello_world/python/hello_world.py" -o /tmp/hs_hello_world.py
ulimit -s 32768 && python3 /tmp/hs_hello_world.py
# video_replayer (10 frames, headless) — expected: "Graph execution finished."
# Always run headless: works with or without a display, avoids GUI failure modes over SSH.
curl -fsSL "${BASE}/video_replayer/python/video_replayer.py" -o /tmp/hs_video_replayer.py
curl -fsSL "${BASE}/video_replayer/python/video_replayer.yaml" -o /tmp/hs_video_replayer.yaml
python3 -c "
c = open('/tmp/hs_video_replayer.yaml').read()
c = c.replace('count: 0','count: 10').replace('repeat: true','repeat: false').replace('realtime: true','realtime: false')
c = c.replace('holoviz:\n width: 854','holoviz:\n headless: true\n width: 854')
open('/tmp/hs_video_replayer_run.yaml','w').write(c)"
ulimit -s 32768 && HOLOSCAN_INPUT_PATH=/opt/nvidia/holoscan/data \
python3 /tmp/hs_video_replayer.py --config /tmp/hs_video_replayer_run.yaml
Note: video_replayer needs the racerx data files. These ship with the Debian package at /opt/nvidia/holoscan/data. If the Debian package is not installed, run sudo /opt/nvidia/holoscan/examples/download_example_data first (requires the apt package to be installed for that script), or set HOLOSCAN_INPUT_PATH to wherever the data lives.
Step 4: Remind the User
They must activate the venv in each new shell session:
source ~/holoscan/venv/bin/activate
ulimit -s 32768 # suppress stack-size warning
Then offer next steps:
- Explore Python examples at
https://github.com/nvidia-holoscan/holoscan-sdk/tree/v<VERSION>/examples - Walk through a specific example:
/explain-example - Start building a custom Holoscan application
Troubleshooting
pip install holoscan-cu12errors with "externally-managed-environment". Ubuntu 24.04 blocks system-wide pip. Create and activate the venv from Step 1 first.ImportError/ wrong CUDA atimport holoscan. Wheel variant doesn't match host CUDA. Uninstall and reinstall the matching one:pip uninstall -y holoscan-cu13 && pip install holoscan-cu12(or vice versa).RuntimeWarning: stack size .... Harmless, but setulimit -s 32768in the current shell to silence it.- Segmentation fault when running an example.
ulimit -s 32768wasn't set. Set it beforepython3 .... video_replayercan't findracerx/.HOLOSCAN_INPUT_PATHisn't pointing at a directory containing it. Install the Debian package for/opt/nvidia/holoscan/data, or setHOLOSCAN_INPUT_PATHto wherever the data lives.source: no such file: ~/holoscan/venv/bin/activatein a new shell. Venv wasn't created or path differs. Re-run Step 1 or correct the path.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
