ComfyUI ModuleNotFoundError: No module named 'sageattention' の修復

No module named 'sageattention' は、必ずしも SageAttention をインストールしろという意味ではありません。

多くの場合は任意の高速化 backend が使えないという warning です。一方で、WanVideoWrapper、HunyuanVideo、LTX、Qwen Image などの動画ワークフローでは、queue 実行時の致命的な失敗になることもあります。

Step 1: 起動 warning か、ワークフロー失敗かを確認する

ログがこれだけなら：

[WARNING] Warning: Could not load sageattention: No module named 'sageattention'
[WARNING] sageattention package is not installed, sageattention will not be available

そして ComfyUI がブラウザ UI まで起動するなら、たいてい緊急対応は不要です。

SageAttention は任意の attention 高速化 backend です。多くのワークフローは sdpa、comfy、torch、auto で動きます。

ワークフローが実際に止まり、動画ノードや attention ノード周辺で traceback が出る場合だけ、次へ進みます。

Step 2: インストール前に SageAttention を外す

まず強制設定を外します。

起動引数に追加した場合

削除します：

--use-sage-attention

その後、ComfyUI を再起動します。

ノードに attention backend の選択肢がある場合

モデルローダー、動画 wrapper、attention 関連ノードで：

sageattn
sageattention
SageAttention

を次のいずれかに変更します：

sdpa
comfy
torch
auto

もう一度 queue してください。

Step 3: ComfyUI が実際に使っている Python を確認する

Windows で一番多い失敗は、ComfyUI とは別の Python にインストールしてしまうことです。

Windows ポータブル版

ComfyUI_windows_portable フォルダーで PowerShell を開きます：

.\python_embeded\python.exe -s -c "import sys; print(sys.executable)"
.\python_embeded\python.exe -s --version

以降の pip show、インストール、アンインストール、検証は、同じ interpreter で実行します。

手動 venv

ComfyUI の起動に使っている venv を有効化してから：

python -c "import sys; print(sys.executable)"
python --version

システム Python、Conda、Windows Store Python ではないことを確認します。

Step 4: Triton を確認する

Windows の SageAttention は Triton で止まることがよくあります。

Windows の配布パッケージ名は通常：

triton-windows

Python 側の import 名は：

import triton

Windows ポータブル版

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

手動 venv

python -m pip show triton-windows
python -c "import triton; print(triton.__version__)"

import triton が失敗するなら、SageAttention を再インストールする前に Triton を直します。

ComfyUI で Triton が見つからない、または使えない場合

Step 5: 本当に SageAttention を入れる必要があるか決める

インストールするのは次の場合だけです：

• ワークフローに sdpa、comfy、torch、auto の代替がない；
• ノード作者またはワークフロー作者が SageAttention を明示的に要求している；
• 動画ワークフローの高速化が目的で、Python/Torch/CUDA/Triton の互換性対応もできる。

単なる起動 warning のためだけに入れないでください。

torch.cuda.is_available() が false、実際の Python が分からない、完全に合う build が見つからない、または sdpa / comfy で動く場合は、インストールしない方が安全です。

Step 6: 必須の場合は環境を記録し、インストールガイドへ進む

Windows には、すべての ComfyUI に共通する SageAttention の万能コマンドはありません。

まず記録します：

nvidia-smi

Windows ポータブル版

.\python_embeded\python.exe -s --version
.\python_embeded\python.exe -s -m pip freeze > sageattention-before.txt
.\python_embeded\python.exe -s -c "import torch; print(torch.__version__); print(torch.version.cuda); print(torch.cuda.is_available())"

手動 venv

python --version
python -m pip freeze > sageattention-before.txt
python -c "import torch; print(torch.__version__); print(torch.version.cuda); print(torch.cuda.is_available())"

wheel を選ぶときは torch.version.cuda を基準にします。nvidia-smi 上部の CUDA Version だけで選ばないでください。

次にこちらへ進みます：

Windows ComfyUI に SageAttention をインストールする

インストール後、このページの Step 7 に戻って検証します。

Step 7: インストール後、同じ Python で検証する

Successfully installed だけでは不十分です。

Windows ポータブル版

.\python_embeded\python.exe -s -m pip show sageattention
.\python_embeded\python.exe -s -c "from sageattention import sageattn; print('SageAttention OK')"

手動 venv

python -m pip show sageattention
python -c "from sageattention import sageattn; print('SageAttention OK')"

その後 ComfyUI を再起動し、元のワークフローを queue します。

No module named 'sageattention' が DLL load failed while importing _fused に変わった場合、インストールした build が実行環境と合っていません。追加インストールを重ねず、ロールバックするか互換 build を選び直します。

まだ失敗する場合

関連ガイド

• Windows ComfyUI に SageAttention をインストールする
• ComfyUI で Triton が見つからない、または使えない場合
• ComfyUI plugin import failed
• ComfyUI dependency conflicts
• ComfyUI startup failed

参考ソース

• SageAttention official GitHub repository
• SageAttention PyPI page
• ComfyUI command-line arguments
• ComfyUI issue: SageAttention installed into the wrong Python
• WanVideoWrapper issue: model loading cannot find SageAttention
• ComfyUI issue: SageAttention DLL load failed
• triton-windows PyPI page
• Triton Windows current project
• Triton Windows historical repository
• NVIDIA CUDA Toolkit, Driver, and Architecture Matrix