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 を使用してください。オプションのコンポーネントホイールは、SDK と完全に一致するバージョンを追加してください。Vision は CV-CUDA と NPP の Python 依存関係を解決します。ドライバーと CUDA 13 ランタイムはホスト側で提供し、Inference はアプリケーション環境に TensorRT 10 があることを想定しています。オプションのプロバイダーを選択した場合は、それぞれ個別に検証してください。 holoscan_vision、holoscan_visualization、holoscan_inference

実行範囲を確認するには、このリリースに対応するソースリファレンスから examples/first_pipeline/python/first_pipeline.py を取得してください。実行前に内容を確認し、venv 内で実行してください。この例の実行範囲は限定されており、RacerX データやディスプレイは必要ありません。対応するチェックアウトがすでにある場合は、そちらを優先してください。Python のバージョン文字列から Git タグを組み立てないでください。Early Access のパッケージバージョンとソースリファレンスは異なる場合があります。4.x の hello_world.py、tensor_interop、video_replayer を使ったスモークテストの手順は、5.x の Python サンプルを示すものではありません。

Python、SDK、コンポーネントの各バージョン、インポート、依存関係、グラフの各チェック、およびスキップしたモジュールテストを報告してください。インポートチェックだけでは、ランタイム全体の適格性確認にはなりません。ランタイムライブラリが見つからない場合は、無関係なシステムパスを変更する前に、選択したコンポーネントの前提条件を確認してください。