ModuleNotFoundError: No module named 'onnx' または 'onnxruntime'（ComfyUI）の修復

コンソールや起動ログに ModuleNotFoundError: No module named 'onnxruntime'、ModuleNotFoundError: No module named 'onnx'、No module named 'onnxruntime.capi'、ComfyUI no module named onnx WanVideoWrapper、または WanVideoWrapper WARNING: FantasyPortrait nodes not available: No module named 'onnx' と表示された場合、まずはエラーが発生したワークフローが、ONNX に依存する顔、姿勢、または補助ノードを実際に使用しているかを確認してください。

WanVideoWrapper の場合、この警告は通常 FantasyPortrait や動画補助ノード付近で発生します。ほとんどのユーザーにとって、CPU版の onnxruntime を導入するのが最も安全な第一選択肢です。GPU版 ONNX Runtime は、ワークフローで真に GPU 推論の加速が必要であり、かつ CUDA/cuDNN のバージョン環境スタックを完全に合わせられる場合のみ検討してください。

DWPose、onnxruntime、または ONNX プロバイダーのロード失敗に関する最新のエラーがある場合は、そのエラーログを基準に対処します。

2026年7月8日時点の Wonderful Launcher テレメトリデータによると、onnxruntime は過去 30日間に 203件の致命的イベントと 6件のインストール、onnx は 111件の致命的イベントと 4件のインストールで確認されました。また、onnxruntime.capi というサブモジュールのバリエーションも報告されています。これらは同じ修復パスに属しますが、別のパッケージです（onnx はモデルファイルのメタ記述用、onnxruntime はそれらモデルを実行する推論エンジンです）。

症状

ComfyUI の起動時、コンソールに以下のような警告またはエラーが表示されます：

WanVideoWrapper WARNING: FantasyPortrait nodes not available: No module named 'onnx'

No module named 'onnxruntime'

ModuleNotFoundError: No module named 'onnxruntime.capi'

DWPose: Onnxruntime not found or doesn't come with acceleration providers, switch to OpenCV with CPU device

特に WanVideoWrapper warning: FantasyPortrait nodes not available: No module named 'onnx' が出ている場合は、ONNX 関連の補助ノードの問題であり、一般的な ComfyUI コアや Manager の登録エラーではありません。

原因

onnx は .onnx モデルファイルをロード・編集するためのモデル交換ライブラリで、onnxruntime はそれらモデルを実行する高速推論エンジンです。通常は両方必要になりますが、すべてのワークフローで必要なわけではありません。

ONNX または ONNX Runtime に依存する主な ComfyUI カスタムノードは以下の通りです：

• ComfyUI-WanVideoWrapper - FantasyPortrait などの動画生成機能
• comfyui_controlnet_aux - DWPose 姿勢検出
• ComfyUI-ReActor - 顔交換（InsightFace / ONNX Runtime 経由）
• ComfyUI_IPAdapter_plus - FaceID（InsightFace 経由）
• ComfyUI_InstantID - 一貫性のある顔画像生成
• ComfyUI-PuLID - 顔特徴保持

これらが不足していると該当ノードはロードされませんが、ComfyUI 自体や他の無関係なノードは問題なく動作し続けます。

修復方法の選定基準

単にカスタムノードのインポートエラーを解消したいだけであれば、CPU版の onnxruntime の導入が最も低リスクです。GPU版 ONNX Runtime は最適化のステップであり、最初の復旧段階には適していません。

インストール手順

正しい Python 環境の特定

インストールは、ComfyUI を起動する Python 環境に対して実行します：

解決方法 1：CPU版のインストール（推奨・低リスク）

ほとんどのユーザーにとって最も安全な手順です：

python -m pip install onnx onnxruntime

Windows ポータブル版の場合：

.\python_embeded\python.exe -s -m pip install onnx onnxruntime

DWPose などの機能は CPU モードでも十分動作します（少し速度が落ちるのみです）。

解決方法 2：GPU加速版のインストール

NVIDIA GPU を所持しており、ONNX 推論を高速化したい場合：

python -m pip install onnx onnxruntime-gpu

※ 注意：onnxruntime と onnxruntime-gpu は同時にインストールしないでください。以前に CPU 版を入れている場合は、事前にアンインストールします：

python -m pip uninstall onnxruntime -y
python -m pip install onnxruntime-gpu

典型的なトラブルと解決策

onnxruntime-gpu 導入後に GPU が使われない

エラー： LoadLibrary failed with error 126 when trying to load onnxruntime_providers_cuda.dll 原因： onnxruntime-gpu が求める CUDA/cuDNN と、使用中の PyTorch ランタイムスタックが不一致です。 解決策： 特別推論速度に困っていない限り、CPU版 onnxruntime に戻すことを推奨します。GPU版を使用したい場合は、現在導入されている PyTorch に紐づく CUDA/cuDNN と適合する特定の ONNX Runtime バージョンを指定してインストールしてください。

CPU版と GPU版の混在

症状： GPU 推論が有効化されない、または環境が不安定化する。 以下を実行して確認します：

python -m pip list | findstr onnxruntime

両方リストにある場合は、一度両方をアンインストールしたのち、片方のみを入れ直します：

python -m pip uninstall onnxruntime onnxruntime-gpu -y
python -m pip install onnxruntime

protobuf バージョン競合

エラー： TypeError: Descriptors cannot be created directly. 解決策： protobuf のバージョン制限を指定してインストールします：

python -m pip install "protobuf>=3.20"

インストールの検証

同じ Python 環境で以下を実行します：

python -c "import onnxruntime as ort; print(ort.__version__, ort.get_available_providers())"

GPU版が正常に入っており CUDA 加速が効く場合は、出力リストに 'CUDAExecutionProvider' が含まれます。'CPUExecutionProvider' のみの場合は、CPU版が入っているか、GPU プロバイダーのロードに失敗しています。

関連ガイド

• ComfyUI No Module Named 'triton'
• 修復 ComfyUI 中的 No module named 錯誤
• ComfyUI 依賴衝突

参照元

• ONNX Runtime 公式インストールガイド