Holoscan Install Debian
NVIDIAOfficialCreated by Holoscan TeamDistributed by NVIDIA
- Skill
- Tool integration
- Software development
- Apache-2.0
- Medium risk
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides a structured approach to installing Holoscan SDK 5.x C++ Debian packages on Ubuntu 24.04 systems. It covers environment verification, repository configuration, package selection, and post-installation validation to ensure the SDK is correctly integrated into the system environment.
What it does
- Verifies platform compatibility for Holoscan 5.x on Ubuntu 24.04.
- Guides the configuration of required CUDA APT repositories.
- Facilitates the selection and installation of core and optional SDK modules.
- Provides simulation steps to prevent dependency conflicts before installation.
- Validates the installation through C++ sample execution and CMake configuration checks.
When to use it
- When setting up a new development environment for Holoscan SDK 5.x.
- When upgrading from previous SDK versions on Ubuntu 24.04.
- When deploying Holoscan C++ libraries and headers to a system.
- When troubleshooting missing dependencies or package conflicts during SDK setup.
Advantages
- Ensures version consistency across core and modular components.
- Reduces risk of system breakage through pre-installation simulation.
- Provides clear verification steps to confirm successful deployment.
- Maintains system integrity by using standard Debian package management.
Usage examples
- “How do I install the full Holoscan 5.x SDK on Ubuntu 24.04?”
- The agent will guide you through checking your system requirements, configuring the necessary APT repositories, simulating the installation of the 'holoscan' package, and executing the final install command.
- “Verify my Holoscan C++ installation.”
- The agent will instruct you to use dpkg-query to list installed packages and run the provided hello_world example to confirm the SDK is functional.
Install
Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/nvidia/holoscan-install-debian/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip holoscan-install-debian.zip -d .agents/skills
Documentation by Holoscan Team
Holoscan 5.x Debian Installation
Release and platform checks
This skill targets Holoscan SDK 5.x. Select the requested 5.x release before
choosing artifacts. Read its release notes and the matching
SDK installation guide.
Select the 5.x documentation version; an unversioned page may describe 4.x.
For an unreleased checkout, use its docs/sdk_installation.mdx and DEVELOP.md.
Early Access binary commands describe planned artifacts, so confirm publication
for the exact release before installing. If unavailable, explain that status
and offer holoscan-install-source; keep the requested 5.x version.
The 5.0 artifact set targets CUDA 13 and dGPU systems on x86_64 or arm64.
Native packages use Ubuntu 24.04; wheels use glibc 2.39 and regular CPython
3.12–3.14. Check the selected release for changes to that matrix. There is no
CUDA 12 variant or separate Tegra/iGPU artifact in this set. A driver reporting
CUDA 12 support needs a compatibility assessment or driver upgrade before a
CUDA 13 installation; the nvidia-smi CUDA field is a driver capability, not
the installed toolkit version. Never infer compatibility from that field alone.
Select packages and inspect availability
This path supplies C++ libraries, headers, CMake configuration, and C++
examples under /usr. Python bindings use holoscan-install-wheel separately.
Support in the planned artifact set is Ubuntu 24.04 x86_64 and SBSA arm64;
SBSA does not imply Tegra/iGPU support.
| Goal | Package |
|---|---|
| Full SDK | holoscan |
| Core libraries only | holoscan-core |
| Optional modules | holoscan-vision, holoscan-visualization, holoscan-inference |
Inspect /etc/os-release, uname -m, nvidia-smi, and existing packages.
Use the release-specific network/local installer from
Holoscan Downloads to configure
the CUDA APT repository when needed. Choose ubuntu2404/x86_64 or
ubuntu2404/sbsa as appropriate; use the published release-specific installer
instructions and package names.
After repository setup is authorized, refresh metadata and inspect candidates:
sudo apt update
apt-cache policy holoscan holoscan-core holoscan-vision holoscan-visualization holoscan-inference
apt-cache madison holoscan holoscan-coreChoose the exact APT version corresponding to the requested 5.x release. A candidate from 4.x is not an available 5.x package. Keep every optional module on the same Core release. Preview dependency changes before installing:
# APT_VERSION is the exact available 5.x Debian version, including its revision.
apt-get --simulate install "holoscan=${APT_VERSION}"For Core-only, substitute holoscan-core. Add selected optional module packages
with their matching versions. Review the simulated transaction for removals or
an existing 4.x installation before applying it.
If simulation fails or proposes changes outside the requested scope, stop and
report the failing command/output or conflicting changes. Resolve the conflict
or obtain authorization for the expanded scope before installing. An existing
4.x installation alone does not block an upgrade the user requested.
After the simulated transaction is acceptable, install the selected package set:
sudo apt install "holoscan=${APT_VERSION}"Verify C++ support
dpkg-query -W 'holoscan*'
dpkg -L holoscan-core-cuda-13The unsuffixed component packages select CUDA 13 native packages, such as
holoscan-core-cuda-13; inspect their installed versions and file lists.
Use the package file list to locate the installed hello_world/cpp/hello_world
and hello_core/cpp/hello_core executables under the system library hierarchy.
Run them and expect Hello Holoscan! and holoscan core sample complete.
Use the installed hello_world source and its CMakeLists.txt for a small
consumer build in a user-writable build directory; verify find_package(holoscan)
and the holoscan::core target. Check that cmake --version reports 4.0 or
newer first; Ubuntu 24.04's default CMake 3.28 cannot configure the consumer.
Inspect package contents rather than exporting the old /opt/nvidia/holoscan/lib
path. Record missing example packages as a verification gap.
Core declares CUDA development dependencies; Vision supplies its CV-CUDA runtime, and Inference recommends TensorRT 10 runtime libraries. Check the application's selected modules and dependencies before claiming full support. Report installed package versions, C++ checks, and any untested GPU/module paths. If Python import is requested, explain the C++/Python package split and use the wheel workflow with the same SDK release.
Files
- ATTRIBUTION.mdAdded by AutoGineer934 B
- BENCHMARK.md7.9 KiB
- LICENSELicence file added by AutoGineer11.2 KiB
- SKILL.md5.0 KiB
- evals/evals.json5.2 KiB
- skill-card.md4.7 KiB
- skill.oms.sig4.5 KiB
evals/evals.json
[
{
"id": "holoscan-install-debian-5x-001",
"question": "Review this request and return the installation decision and a command plan only. Host and publication facts below are test fixtures, not claims about this sandbox. Use the supplied facts and local skill guidance; do not execute commands, contact services, install packages, pull images, build, or run examples. Identify any missing prerequisite that must be checked before execution. Request: Set up native C++ Holoscan 5.x on Ubuntu 24.04 x86_64; the 5.x packages are published.",
"expected_skill": "holoscan-install-debian",
"expected_script": null,
"ground_truth": "Produce a plan without executing it. Install an explicitly selected 5.x package version with matching modules.",
"expected_behavior": [
"Return the decision, prerequisite checks, and proposed commands without executing installations or external lookups; use the supplied host and release facts as fixtures.",
"Inspect architecture, OS, driver, and APT candidates.",
"Choose holoscan or holoscan-core with exact 5.x APT version.",
"Preview dependency changes and keep modules on the same release.",
"Verify installed C++ examples under /usr."
]
},
{
"id": "holoscan-install-debian-5x-002",
"question": "Review this request and return the installation decision and a command plan only. Host and publication facts below are test fixtures, not claims about this sandbox. Use the supplied facts and local skill guidance; do not execute commands, contact services, install packages, pull images, build, or run examples. Identify any missing prerequisite that must be checked before execution. Request: I use Ubuntu 24.04 arm64 SBSA with a supported dGPU and want Core plus Vision, not Python.",
"expected_skill": "holoscan-install-debian",
"expected_script": null,
"ground_truth": "Produce a plan without executing it. Use the SBSA repository and matching C++ Core and Vision packages.",
"expected_behavior": [
"Return the decision, prerequisite checks, and proposed commands without executing installations or external lookups; use the supplied host and release facts as fixtures.",
"Distinguish SBSA from Tegra.",
"Choose holoscan-core and holoscan-vision with matching versions.",
"Avoid the 4.x holoscan-cuda-12 and holoscan-cuda-13 names.",
"Explain that Python bindings are separate."
]
},
{
"id": "holoscan-install-debian-5x-003",
"question": "Review this request and return the installation decision and a command plan only. Host and publication facts below are test fixtures, not claims about this sandbox. Use the supplied facts and local skill guidance; do not execute commands, contact services, install packages, pull images, build, or run examples. Identify any missing prerequisite that must be checked before execution. Request: APT only offers Holoscan 4.6, but I requested 5.x EA. Can you install the metapackage?",
"expected_skill": "holoscan-install-debian",
"expected_script": null,
"ground_truth": "Produce a plan without executing it. Stop before installing a wrong release and offer a source alternative.",
"expected_behavior": [
"Return the decision, prerequisite checks, and proposed commands without executing installations or external lookups; use the supplied host and release facts as fixtures.",
"Inspect exact available versions.",
"Do not install 4.x as a fallback.",
"Report missing 5.x publication and suggest source."
]
},
{
"id": "holoscan-install-debian-5x-004",
"question": "I need the Python 5.x API in a virtualenv without system-wide C++ packages.",
"expected_skill": null,
"expected_script": null,
"ground_truth": "Use the wheel workflow.",
"expected_behavior": [
"Do not invoke Debian installation for Python-only setup."
]
},
{
"id": "holoscan-install-debian-5x-005",
"question": "Review this request and return the installation decision and a command plan only. Host and publication facts below are test fixtures, not claims about this sandbox. Use the supplied facts and local skill guidance; do not execute commands, contact services, install packages, pull images, build, or run examples. Identify any missing prerequisite that must be checked before execution. Request: I authorized upgrading Holoscan 4.6 to the published 5.0 C++ SDK. The APT simulation also proposes removing openssh-server, which I did not request. Should the install proceed?",
"expected_skill": "holoscan-install-debian",
"expected_script": null,
"ground_truth": "Stop before installation because the simulated transaction changes unrelated packages outside the authorized SDK upgrade. Preserve the requested upgrade as a valid goal.",
"expected_behavior": [
"Use only the supplied fixtures and local skill guidance; return a plan without executing commands or contacting services.",
"Report the unexpected openssh-server removal and stop before sudo apt install.",
"Resolve the conflict or obtain explicit authorization for the expanded changes; do not apply them automatically.",
"Do not reject the requested SDK upgrade solely because Holoscan 4.6 is installed."
]
}
]
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Security
What our scanner noticed· Medium risk
- Large base64-encoded blobs
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- Holoscan Team
- Publisher
- NVIDIA (Official)
- Distributed by
- NVIDIA
- Source
- NVIDIA/skills · skills/holoscan-install-debian · commit fce3cca
- Licence
- Apache License 2.0 (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE-APACHE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Holoscan Team or NVIDIA.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download holoscan-install-debian.zip