开发与工程 ✓ NVIDIA · 官方 holoscancmakedockersource-buildcudanvidia-gpu

Holoscan SDK 源码构建

在 Docker 容器中从源码构建 Holoscan SDK,并生成可供 CMake 使用的本地安装目录。

FollowSkills 评估 · FSRS-2.0
不推荐
49/ 100 五分制 2.5 / 5
信任安全13 / 25 · 2.6/5

说明了 Linux、NVIDIA GPU、Docker、GPU 透传及磁盘需求,并提供故障恢复路径;但包含 sudo、远程 curl、系统软件源修改和 Docker GPU 权限,缺少执行前明确确认、依赖校验/固定版本、数据流披露及完整回滚方案,因此扣分。

可靠稳定8 / 20 · 2.0/5

步骤顺序清晰,涵盖前置检查、构建、测试、缓存清理和常见故障,且基准报告显示较高正确性;但本次为静态审查,未执行复现,命令和 ./run 选项依赖外部仓库版本,异常输入和失败诊断覆盖有限,因此受静态上限约束并扣分。

适用触发9 / 15 · 3.0/5

用途、目标用户、触发条件和非适用场景较明确,包含 debug、aarch64 与 iGPU 情形,并有负向 pip 评测;但仅支持 Linux 加 NVIDIA GPU,中文支持未说明,核心文档、仓库和安装依赖依赖海外服务,面向中国大陆的可达性与替代路径未交代,因此扣分。

规范维护8 / 15 · 2.7/5

具有 frontmatter、版本、许可证、作者、标签、分步结构、限制、测试和故障排查;但缺少推荐的 Instructions 和 Examples 章节,没有变更日志、依赖版本矩阵或明确维护更新流程,skill-card 与正文输出描述也较粗略,因此扣分。

有效结果7 / 15 · 2.3/5

核心目标是指导从源码构建并产出可供 CMake 使用的安装树,命令、构建类型、测试和输出路径均可直接采用;基准文件报告了正向任务和较高效果分数,但静态审查无法验证实际产物或测试通过,且用户仍需适配具体版本与环境,因此按静态上限给分。

证据核验4 / 10 · 2.0/5

正文引用官方文档和上游仓库,评测文件提供了任务、期望行为和汇总结果,具备一定可审计性;但没有本技能专属的提交测试、CI 日志或独立复现材料,基准结果主要是声明性报告,因此扣分。

证据充分度: 评估于 2026年7月20日 审查版本 55f18499943e
使用前请注意
  • 执行前应确认用户同意 sudo、系统软件源修改、远程下载和 Docker GPU 权限,并审查远程脚本、镜像及依赖来源。
  • 应锁定与目标 Holoscan 版本匹配的提交、标签、CUDA 和架构参数;当前说明可能因上游 ./run 变化而失效。
  • 构建和测试可能消耗约 20 GB 磁盘、GPU 资源及较长时间;文档未提供完整清理或回滚流程。
  • 面向中国大陆用户时,应预先确认 NVIDIA 文档、GitHub、容器镜像和软件源的可达性,并准备镜像或离线替代方案。
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

该技能指导用户通过 Holoscan SDK 源码树中的 ./run 脚本完成构建、安装和测试。构建过程在带 NVIDIA GPU 支持的 Docker 容器内执行,而不是纯裸机编译。它适合需要调试符号、自定义 CMake 选项或使用未被已发布 Conda、容器、apt 或 wheel 包支持配置的用户。构建结果可作为 CMake 依赖提供给本地应用。

检查 git、Docker、NVIDIA GPU 透传和 Docker buildx;克隆 nvidia-holoscan/holoscan-sdk 并可切换到版本标签;运行 ./run build,支持 debug、RelWithDebInfo、aarch64、igpu 和 dryrun 选项;在缓存变更时运行 ./run clear_cache;运行指定的 Holoscan 示例测试;通过 ./run get_build_dir 和 ./run get_install_dir 定位构建及安装目录;指导应用使用 Holoscan_ROOT 或 CMAKE_PREFIX_PATH 指向安装树。

  1. Holoscan 开发者需要已发布安装包未提供的调试符号或自定义 CMake 配置时,从源码构建 SDK。
  2. 使用 Jetson 或 IGX iGPU 配置的工程师需要通过 --gpu igpu 构建 Holoscan SDK 时。
  3. 需要为 ARM64 目标交叉编译 Holoscan SDK,并已准备 qemu-user-static 的开发者。
  4. 希望从稳定版本标签构建 SDK,并在构建后运行 C++ 和 Python 示例验证的用户。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖从环境检查、源码获取到构建、测试和 CMake 集成的完整流程。
  • 支持调试构建、带调试符号的发布构建、aarch64 交叉编译和 iGPU 构建。
  • 包含 GPU 透传、buildx、CMake 缓存和测试正则表达式的具体排障建议。
局限
  • 必须使用 Docker,不能视为真正的裸机源码构建。
  • 需要 Linux、NVIDIA GPU 与驱动、Docker GPU 透传,并预留约 20 GB 磁盘空间。
  • 首次干净构建预计需要 10–30 分钟;来源未提供不同硬件上的性能数据或成功率证据。
  • 技能要求先查阅会随版本变化的官方安装文档,但没有在自身内容中固定具体版本、CUDA 主版本或全部支持平台。

如何安装这个 Skill?

先安装默认 skills CLI 所需环境,然后运行:

npx skills add nvidia/skills --skill holoscan-install-source --yes

README 未说明该 CLI 的具体安装命令。安装后,技能会在代理重新加载技能并遇到相关任务时可用。

如何使用这个 Skill?

可向代理提出:“当已发布 Holoscan 包不满足需求时,指导我从源码构建 Holoscan SDK,并运行推荐测试。”典型构建步骤包括:

mkdir -p ~/holoscan/
git clone https://github.com/nvidia-holoscan/holoscan-sdk.git
cd ~/holoscan/holoscan-sdk
./run build
./run test

构建前必须查阅官方“Build from Source”安装说明及对应版本的 README/DEVELOP.md;文档要求应优先于本技能中的默认步骤。

这个 Skill 与同类方案有什么区别?

它明确建议仅在 Conda、容器、apt 或 wheel 等已发布包不满足需求时使用;因此这些已发布安装方式是其适用场景上的替代方案,但本技能没有提供它们的具体操作步骤。

常见问题

这是裸机编译吗?
不是。./run 会在 Docker 容器内完成构建,因此主机仍需 Docker 和 NVIDIA Container Toolkit。
什么时候应该采用这个技能?
当已发布的 Conda、容器、apt 或 wheel 包无法满足调试符号、自定义 CMake 选项或不受支持配置等需求时。
GPU 透传失败怎么办?
检查 NVIDIA Container Toolkit,并确认 docker run --gpus all 能在容器中执行 nvidia-smi;技能还提供了重新配置 Docker runtime 的命令。
构建产物在哪里?
构建目录通常为 build-cu<N>-<arch>/,安装目录通常为 install-cu<N>-<arch>/;也可运行 ./run get_build_dir 和 ./run get_install_dir 查询。

同仓库的其他 Skills

均来自 NVIDIA/skills

自动化与运维 ✓ NVIDIA · 官方

Holoscan NGC 容器安装助手

通过 NGC Docker 容器安装、验证并启动 NVIDIA Holoscan SDK。

开发与工程 ✓ NVIDIA · 官方

Holoscan SDK 安装向导

根据主机环境选择并引导完成 Holoscan SDK 的合适安装方式。

自动化与运维 ✓ NVIDIA · 官方

TAO NVIDIA GPU 主机配置

为 TAO 的 Docker 与 Kubernetes GPU 主机检查并配置 NVIDIA 驱动、CUDA 和容器运行时。

开发与工程 ✓ NVIDIA · 官方

Holoscan Ubuntu 原生安装助手

在 Ubuntu 上通过 NVIDIA apt 仓库安装并验证 Holoscan SDK C++ 环境。

开发与工程 ✓ NVIDIA · 官方

Holoscan Python Wheel 安装助手

在 Linux NVIDIA GPU 环境中,将 Holoscan SDK Python 绑定安装到虚拟环境并完成基础验证。

开发与工程 ✓ NVIDIA · 官方

Holoscan Conda 安装助手

在 Linux x86_64 的 CUDA 13 环境中,通过 Conda 安装并验证 Holoscan SDK。

开发与工程 ✓ NVIDIA · 官方

TAO Sparse4D 训练技能

帮助代理训练、评估、导出、量化和推理多摄像头时序3D检测跟踪模型。

自动化与运维 ✓ NVIDIA · 官方

cuOpt 安装助手

指导在 Python、C 或 REST 服务中安装并验证 NVIDIA cuOpt。

自动化与运维 ✓ NVIDIA · 官方

TAO 本地 Docker 运行

帮助 AI 代理在本机或远程单节点 Docker GPU 主机上运行 TAO 作业。

自动化与运维 ✓ NVIDIA · 官方

NVIDIA GPU Docker 运行规范

为 NVIDIA GPU 容器工作负载提供可复用的 Docker 运行、认证、挂载与故障排查规范。

数据与分析 ✓ NVIDIA · 官方

TAO AOI 图像挖掘

使用统一图像编码器嵌入目标与源图像,并挖掘用于增强训练的近邻 AOI 图像。

自动化与运维 ✓ NVIDIA · 官方

VSS 多摄像头三维检测追踪部署

部署基于 DeepStream 与 BEV Fusion 的多摄像头三维感知服务。

开发与工程 ✓ NVIDIA · 官方

NVIDIA 技能发现器

帮助代理在 NVIDIA 产品与工作流中发现并选择合适的技能。

数据与分析 ✓ NVIDIA · 官方

TAO Deformable DETR 目标检测

帮助 AI 代理训练、评估、导出、量化并部署轻量级 Deformable DETR 目标检测模型。

开发与工程 ✓ NVIDIA · 官方

NeMo MBridge GPU 内存调优

诊断 Megatron Bridge 训练中的 GPU OOM,并降低碎片、激活和 PEFT 内存占用。

开发与工程 ✓ NVIDIA · 官方

cuPyNumeric 迁移就绪度评估

在投入大规模移植工作前,判断 NumPy 代码能否在 GPU 和多 GPU 环境中有效扩展。

数据与分析 ✓ NVIDIA · 官方

TAO Grounding DINO 开放词汇检测

用文本提示训练和部署无需固定类别词表的目标检测模型。

自动化与运维 ✓ NVIDIA · 官方

Nemotron Speech 语音 NIM 技能

指导部署和运行 NVIDIA Riva 的语音识别、语音合成与翻译 NIM。

开发与工程 ✓ NVIDIA · 官方

DeepStream 管道构建器

通过交互式需求收集,为 NVIDIA DeepStream 生成并验证可运行的 GStreamer 推理管道。

开发与工程 ✓ NVIDIA · 官方

DOCA GPI GPU 直驱 RDMA 技能

指导 CUDA 内核绕过主机 CPU,直接从 GPU 内存驱动 RDMA 队列。

相关 Skills