ModuleNotFoundError: No module named 'triton'（ComfyUI）の修復

検索キーワード ModuleNotFoundError: No module named 'triton'、comfyui no module named triton、または起動ログの Found comfy_kitchen backend triton: {'available': False, ...} が表示された場合、まずはこれが単なるオプションの警告なのか、ワークフローを阻害する致命的なエラーなのかを判断する必要があります。

ComfyUI が通常通り起動し、一般的なワークフローが動作している場合は、Triton を気にする必要はありません。Easy-SAM3、Trellis、WanVideoWrapper、SageAttention などのノードが Triton のインポート失敗によりエラーで停止している場合は、ComfyUI を起動しているのと同じ Python 環境で Triton を修復する必要があります。Windows 環境では、通常の pip install triton ではなく、必ず triton-windows を使用してください。

エラーが単に No module named 'sageattention' のみで、Triton について言及されていない場合は、先に SageAttention 缺失 を参照してください。

Wonderful Launcher の 2026年7月8日までの 30日間のテレメトリデータによると、triton は欠如モジュールの中で最大のホットスポットとなっています。29件のインストールインスタンスで comfy_kitchen 起動時に致命的な No module named 'triton' エラーが発生し、さらに 13件で致命的な Triton インポートエラー、35件でオプションの comfy_kitchen Triton 警告が発生しました。本ページで「警告の無視」と「致命的なエラーの修復」を分けて議論しているのはこれが理由です。

クイックリファレンス

テレメトリに基づく問題の分類

起動時テレメトリデータは2つの異なる Triton パターンを示しています：

同じ警告ログが繰り返し表示されてもワークフローが動作している場合は、単なるノイズです。特定のカスタムノードが triton のインポートで停止した場合は、修復手順が必要です。

ログに comfy_kitchen backend triton と表示されている場合

この正確なログ行は、単なる機能報告であり、必ずしもクラッシュを意味しません：

Found comfy_kitchen backend triton: {'available': False, 'disabled': True, 'unavailable_reason': "ImportError: No module named 'triton'", 'capabilities': []}

ComfyUI が通常通り開いて機能する場合、このログ行を消すためだけに Triton を修復する必要はありません。Easy-SAM3、Trellis、WanVideoWrapper、SageAttention などのバックエンド使用時にワークフローがこのメッセージの直後にエラー停止する場合のみ、Triton を修復対象とします。

切り分けは単純です。起動時のレポートのみであれば「静観」、ワークフローのインポートやキュー実行時の失敗であれば「同じ Python 環境での修復」です。

ログのパターン

起動時に以下のようなログが表示されることがあります：

Found comfy_kitchen backend triton: {'available': False, 'disabled': True, 'unavailable_reason': "ImportError: No module named 'triton'", 'capabilities': []}

または、ワークフロー実行時に以下のように失敗します：

ModuleNotFoundError: No module named 'triton'

起動ログはただの利用可否の報告ですが、ワークフロー失敗の場合は異なります。いずれかのノードが実際に triton をロードしようとして動作を停止しています。

Triton の ComfyUI での役割

Triton は、GPU プログラミング言語およびコンパイラであり、PyTorch コンパイラパス、SageAttention、およびいくつかの新しい加速バックエンドで活用されています。

ComfyUI の通常の画像生成には Triton は不要です。CUDA が有効な PyTorch は Triton なしで正常に動作します。

Triton が重要になるのは以下のケースです：

• SageAttention またはそれをラップしたノードを使用する場合
• torch.compile またはコンパイルカーネルが有効なカスタムノードを使用する場合
• comfy_kitchen などの加速バックエンドを使用する場合
• Triton による加速を明示的に要求する動画や LLM のワークフローを使用する場合

これらを使用しない場合、Triton の修復は環境を不安定にするリスクを増やすだけでメリットはありません。

なぜ SageAttention と Triton は関連しているのか

ComfyUI のサポートログにおいて、SageAttention と Triton はしばしば同じ修復パス上で発生します。

SageAttention はユーザーが有効化したい加速機能で、Triton は SageAttention や隣接するコンパイルコードがカーネル構築に必要とする基礎パッケージです。このため、SageAttention のインストールは以下の3通りの異なるエラーとして現れます：

安全な手順は、ComfyUI が起動することを確認し、Python 環境を特定し、エラーが出たワークフローが真に Triton を必要としている場合のみ修復を行い、Triton が正常にインポート可能になってから SageAttention のインポートを検証することです。

ステップ 1：致命的なエラーかどうか判断する

まず、ComfyUI が起動時の以下のログに到達するか確認します：

To see the GUI go to: http://127.0.0.1:8188

ブラウザで GUI が開き、デフォルトの単純なワークフローが動作する場合は、Triton のエラーログは無視して構いません。正常に動作している環境に、不要な加速パッケージを追加でインストールしないでください。

特定のワークフローがエラーで停止した場合は、スタックトレースを読み、どのパッケージが Triton を要求しているか確認します。多くは SageAttention や動画ワークフロー（Wan/LTX など）関連です。

ステップ 2：ComfyUI が実際に使用している Python の確認

修復の失敗のほとんどは、pip をシステム側の Python に実行してしまい、ComfyUI 側（ポータブル内蔵 Python や仮想環境）に反映されていないことが原因です。

GitHub 経由で導入した Windows ポータブル版の場合、ポータブル版のルートディレクトリ（run_*.bat や python_embeded、ComfyUI があるフォルダ）で以下を実行して確認します：

.\python_embeded\python.exe -s -c "import sys; print(sys.executable); print(sys.version)"
.\python_embeded\python.exe -s -c "import torch; print(torch.__version__, torch.version.cuda, torch.cuda.is_available())"
.\python_embeded\python.exe -s -m pip show triton triton-windows

手動インストール（Git クローン）の場合は、起動に使用している venv をアクティベートして以下を実行します：

python -c "import sys; print(sys.executable); print(sys.version)"
python -c "import torch; print(torch.__version__, torch.version.cuda, torch.cuda.is_available())"
python -m pip show triton triton-windows

torch.cuda.is_available() が False を返す場合は、先に PyTorch/CUDA の環境を修復してください。Triton を入れても、CPU 版の PyTorch が CUDA 対応になるわけではありません。

ComfyUI Desktop などの場合は、アプリ内の環境設定や内蔵コンソールを使用してください。ポータブル版の python_embeded パスが存在するとは限りません。

ステップ 3：Windows 環境では通常の triton パッケージをインストールしない

Windows 上の ComfyUI では、通常の pip install triton ではなく、triton-windows パッケージをインストールします。

もしすでに誤って標準の triton をインストールしてしまっている場合は、同じ Python 環境からアンインストールします：

.\python_embeded\python.exe -s -m pip uninstall -y triton

その後、triton-windows をインストールします：

.\python_embeded\python.exe -s -m pip install -U "triton-windows<3.7"

手動インストールの仮想環境（venv）の場合：

python -m pip uninstall -y triton
python -m pip install -U "triton-windows<3.7"

バージョン上限を指定しているのは、現在の PyTorch 環境と互換性のない将来の Triton バージョンがインストールされるのを防ぐためです。

ステップ 4：PyTorch と Triton のバージョンマッチング

triton-windows は Triton のマイナーバージョンを追跡しており、PyTorch のバージョンごとに対応する Triton バージョンが存在します。

互換性テーブルを参考に、適切なバージョンを選択してください：

Python 3.12 や 3.13 を使用している現在のポータブル版/Desktop 環境では、まず導入済みの PyTorch バージョンを確認した上で、適切な Triton バージョンを選択してインストールします。

ステップ 5：ポータブル版内蔵 Python での include と libs の処理

一部の ComfyUI ポータブル版では、triton-windows のインポートは成功するものの、コンパイル時に Python のヘッダーファイルやライブラリが見つからず失敗することがあります。

その場合は、内蔵 Python (python.exe の配置場所) の隣に以下のフォルダが存在するか確認します：

• include
• libs

libs と Lib を混同しないようにしてください。Lib は通常の Python ライブラリフォルダであり、この修復のために変更してはなりません。

コンパイル時に Python ヘッダーやライブラリの欠如を知らせるエラーが出た場合は、triton-windows リポジトリの指示に従い、使用中の Python バージョンに対応する include および libs ファイルを配置してください。

ステップ 6：起動前に検証する

ComfyUI を起動する前に、同じ Python 環境でインポートテストを行います：

.\python_embeded\python.exe -s -c "import triton; print(triton.__version__)"

また、PyTorch が正常に CUDA を認識していることも確認します：

.\python_embeded\python.exe -s -c "import torch; print(torch.__version__, torch.version.cuda, torch.cuda.is_available())"

このインポートテストが失敗する場合、ComfyUI 上でもエラーになります。サーバーを起動する前に Python 環境を修復してください。

典型的なエラーと解決策

推奨されないアクション

• ポータブル版の ComfyUI に反映されることを期待して、システムの Python に triton をインストールすること。
• 起動時のログ能力一覧に表示されているというだけの理由で Triton をインストールすること。
• 異なるガイドのランダムな SageAttention、PyTorch、CUDA、Triton の wheel ファイルを混ぜてインストールすること。
• 管理者権限が必要ない状況で、管理者としてパッケージ修復を行うこと。
• 指示に libs と書かれている場合に、python_embeded\Lib を変更すること。

Triton 修復を見送るべきケース

以下に該当する場合は、修復を見送ってください：

• ComfyUI が通常通り開いてワークフローも流れる場合
• CPU-only 版の PyTorch を使用している場合
• AMD や Intel の GPU パスを使用しており、エラーが NVIDIA CUDA 前提のノードで起きている場合
• 真のエラー原因がカスタムノードのファイル不足、モデル不足、Hugging Face 接続問題などの場合

複数のパッケージが同時にエラーを吐く場合は、ComfyUI 常见问题 または 如何修复 ComfyUI 插件导入失败错误 を確認してください。

関連ガイド

• ComfyUI No Module Named 'sageattention'：忽略还是修复？
• 修復 ComfyUI 中的 No module named 錯誤
• ComfyUI 依賴衝突
• ComfyUI Torch Not Compiled With CUDA Enabled
• GPU 兼容性
• ComfyUI 常見問題

参照元

• triton-windows GitHub リポジトリ
• triton-windows PyPI ページ
• ComfyUI issue: No module named 'triton'
• ComfyUI issue: Triton がデスクトップアプリで動作しない
• ComfyUI フォーラム: Windows 上の comfy_kitchen backend triton