holoscan-install-wheel

Holoscan 5.x Python Wheel 安装

发布版本与平台检查

此技能面向 Holoscan SDK 5.x。选择所需的 5.x 版本后，再选择安装包。阅读该版本的发行说明和对应的 SDK 安装指南。 选择 5.x 文档版本；未指定版本的页面可能介绍的是 4.x。 对于尚未发布的代码检出版本，请使用其 docs/sdk_installation.mdx 和 DEVELOP.md。 Early Access 二进制命令描述的是计划提供的安装包，因此安装前请确认对应确切版本已发布。如果尚未发布，请说明当前状态， 并提供 holoscan-install-source；保留所需的 5.x 版本。

5.0 安装包面向 CUDA 13，以及 x86_64 或 arm64 架构的 dGPU 系统。 原生软件包使用 Ubuntu 24.04；Wheel 使用 glibc 2.39 和常规 CPython 3.12–3.14。请查看所选版本，确认此兼容矩阵是否有变化。此安装包集合中没有 CUDA 12 版本或单独的 Tegra/iGPU 安装包。报告支持 CUDA 12 的驱动需要先评估兼容性或升级驱动，才能安装 CUDA 13；nvidia-smi 中的 CUDA 字段表示驱动支持的能力，而非已安装的工具包版本。切勿仅凭该字段判断兼容性。

选择发行方式

Wheel 包含 Python 绑定、类型信息和原生运行时库。 C++ 头文件、CMake 文件、示例和示例数据需单独获取。进行原生 C++ 开发时，请使用 Debian 软件包或从源代码构建。

目标	发行方式
完整堆栈	holoscan（会选择 holoscan-cu13）
仅核心	holoscan-core-cu13
可选模块	holoscan-vision-cu13、holoscan-visualization-cu13、holoscan-inference-cu13

检查主机、python3 --version 和 getconf GNU_LIBC_VERSION。确认使用的是 常规 CPython 3.12–3.14、glibc 2.39 或更新版本、兼容的 Linux 架构，以及 CUDA 13 驱动/运行时前置条件。激活 Conda 环境 并不代表支持 Conda 软件包。建议为此工作流单独创建 venv。 如果不满足这些前置条件，请指出未通过的检查，并在安装前停止。将驱动版本与所选版本文档中注明的 CUDA 13 驱动要求进行比较；仅凭工具包版本不足以判断。

在 PyPI 或所选版本文档注明的软件包索引中，确认确切的 5.x 发行版本已发布；预留的软件包名称并非可安装的 SDK。 如果该版本不存在，请提供源代码安装方式，而不是将未固定版本的软件包解析为 4.x。 所有组件都必须使用相同的 SDK 版本。

安装并验证

如果安装或验证命令失败，请停止并报告失败的命令及其输出。如果任何前置条件、软件包索引、试运行、安装、依赖项或导入检查失败，请勿继续执行示例，也不要报告成功。

请选择一个新的 venv 路径，或在检查用户所选环境的内容后复用该环境。安装前说明所选的软件包：

python3 -m venv ~/holoscan/venv-5x
source ~/holoscan/venv-5x/bin/activate
# SDK_VERSION is the exact published Python distribution version for 5.x.
python -m pip index versions holoscan
python -m pip install --dry-run "holoscan==${SDK_VERSION}"
python -m pip install "holoscan==${SDK_VERSION}"
python -m pip check
python -m pip list --format=freeze
python -c 'import holoscan as hs; print(hs.__version__); print(hs.RealtimeClock); print(len(hs.registry.operators()))'

仅使用 Core 时，请在索引、试运行和安装命令中使用 holoscan-core-cu13。添加可选组件 wheel 时，必须使用完全匹配的 SDK 版本。Vision 会解析 CV-CUDA 和 NPP Python 依赖项。主机需提供驱动程序和 CUDA 13 运行时；Inference 需要应用环境中存在 TensorRT 10。选择可选提供程序时，请分别验证：holoscan_vision、holoscan_visualization 和 holoscan_inference。

为覆盖执行情况，请从与此版本对应的源代码 ref 获取 examples/first_pipeline/python/first_pipeline.py。执行前检查该文件，并在 venv 中运行；该示例执行时间有限，不需要 RacerX 数据或显示设备。优先使用已有的匹配代码库检出。不要根据 Python 版本字符串拼接 Git 标签：Early Access 打包版本与源代码 ref 可能不同。4.x 的 hello_world.py、tensor_interop 和 video_replayer 烟雾测试序列并不适用于 5.x Python 示例。

请报告 Python、SDK 和组件的版本，以及导入、依赖项和图检查结果，并说明跳过的模块测试。仅通过导入检查并不代表已完成完整运行时资格验证。缺少运行时库时，应先追溯到所选组件的前置条件，再更改无关的系统路径。