用途:在 Linux x86_64、NVIDIA GPU 且驱动为 CUDA 13 的主机上,把 Holoscan SDK(Python 运行时或 C++ 开发头文件)装进 Conda 环境。需具备 conda(推荐 Miniforge),并能否访问 conda-forge、rapidsai 与 docs.nvidia.com。
主要能力与包角色:libholoscan 为 C++ 运行库符号(自动依赖);holoscan 为 Python 绑定;libholoscan-dev 自 v4.1.0 起为独立包,含头文件与 CMake 配置;rmm 为 holoscan 未声明的运行时依赖,缺它 import holoscan 会失败;ucxx 用于分布式/多进程;cuda-version=13 固定 CUDA 13 元包。
用法要点:安装前先查阅官方文档 Conda 章节,以文档为准。检查 conda 与 nvidia-smi,缺 conda 可静默安装 Miniforge。随后创建环境并激活:conda create -n holoscan python=3.13 -y;conda activate holoscan。按目标选择包安装:conda install <packages> rmm ucxx cuda-version=13 -c rapidsai -c conda-forge -y;频道顺序需 rapidsai 在前,否则求解器可能锁到旧版 holoscan。C++ 开发另装 cxx-compiler cmake ninja。运行任何 Holoscan 应用建议先执行 ulimit -s 32768,否则部分应用可能段错误。
限制:仅 CUDA 13(v4.3.0 起),CUDA 12 驱动应改用容器或 wheel 安装;仅 Linux x86_64,conda-forge 不支持 aarch64/iGPU;每个运行 Holoscan 的新 shell 都需 source conda 并激活环境并设置 ulimit。
验证与排错:Python 用 python3 -c "import holoscan; print(holoscan.version)" 验证,C++ 用 ls "$CONDA_PREFIX/include/holoscan"。常见问题包括 librmm.so 缺失(补装 rmm)、求解器选中旧版(调整频道顺序)、启动段错误(设置 ulimit)、find_package(holoscan) 失败(装 libholoscan-dev)以及新 shell 找不到 conda(source ~/miniforge3/etc/profile.d/conda.sh)。