ComfyUI ModuleNotFoundError: No module named 'sageattention' beheben

No module named 'sageattention' heißt nicht automatisch, dass du SageAttention installieren solltest.

Oft ist es nur eine Warnung für ein optionales Beschleunigungs-Backend. In Video-Workflows wie WanVideoWrapper, HunyuanVideo, LTX oder Qwen Image kann es aber auch ein echter Fehler beim Queue-Lauf sein.

Schritt 1: Warnung oder Workflow-Fehler?

Wenn nur Folgendes im Log steht:

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

und ComfyUI bis zur Browser-Oberfläche startet, ist das normalerweise kein Notfall.

SageAttention ist ein optionales Attention-Beschleunigungs-Backend. Viele Workflows laufen mit sdpa, comfy, torch oder auto.

Gehe erst weiter, wenn der Workflow wirklich stoppt, besonders wenn der Traceback in Video- oder Attention-Nodes entsteht.

Schritt 2: SageAttention zuerst deaktivieren

Wenn du ein Startflag gesetzt hast

Entferne:

--use-sage-attention

Starte ComfyUI neu.

Wenn der Workflow ein Attention-Backend-Dropdown hat

Ändere in Model Loadern, Video-Wrappern oder Attention-Nodes:

sageattn
sageattention
SageAttention

auf:

sdpa
comfy
torch
auto

Queue den Workflow erneut.

Schritt 3: Das echte Python von ComfyUI finden

Der häufigste Windows-Fehler ist eine Installation in System-Python, während ComfyUI ein anderes Python nutzt.

Windows Portable

Öffne PowerShell im Ordner ComfyUI_windows_portable:

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

Alle späteren pip show-, Installations-, Uninstall- und Prüfbefehle müssen denselben Interpreter verwenden.

Manuelle venv

Aktiviere die venv, mit der ComfyUI startet:

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

Stelle sicher, dass es nicht System-Python, Conda oder Windows Store Python ist.

Schritt 4: Triton prüfen

SageAttention auf Windows scheitert oft an Triton.

Der Windows-Paketname ist meist:

triton-windows

Der Python-Import bleibt:

import triton

Windows Portable

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

Manuelle venv

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

Wenn import triton fehlschlägt, installiere SageAttention nicht immer wieder neu. Repariere zuerst Triton:

Triton fehlt oder ist in ComfyUI nicht verfügbar

Schritt 5: Prüfen, ob SageAttention wirklich nötig ist

Installiere SageAttention nur, wenn:

• der Workflow keine Alternative wie sdpa, comfy, torch oder auto hat;
• der Node- oder Workflow-Autor SageAttention ausdrücklich verlangt;
• du bewusst einen Video-Workflow optimierst und Python/Torch/CUDA/Triton-Kompatibilität prüfen kannst.

Installiere es nicht nur wegen einer Startwarnung.

Wenn torch.cuda.is_available() false ist, du das echte Python nicht kennst, kein passendes Build findest oder der Workflow nach sdpa / comfy läuft, ist Nicht-Installieren die bessere Reparatur.

Schritt 6: Wenn Installation nötig ist, Umgebung sichern und Installationsguide nutzen

Für Windows gibt es keinen universellen SageAttention-Befehl für alle ComfyUI-Setups.

Speichere zuerst:

nvidia-smi

Windows Portable

.\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())"

Manuelle 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())"

Wähle Wheels nach torch.version.cuda, nicht nach der CUDA-Version oben in nvidia-smi.

Danach weiter hier:

SageAttention in Windows ComfyUI installieren

Kehre danach zu Schritt 7 auf dieser Seite zurück.

Schritt 7: Nach der Installation im selben Python prüfen

Successfully installed reicht nicht.

Windows Portable

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

Manuelle venv

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

Starte ComfyUI neu und queue den ursprünglichen Workflow.

Wenn aus No module named 'sageattention' plötzlich DLL load failed while importing _fused wird, passt das installierte Build nicht zur Laufzeit. Rollback oder ein kompatibles Build ist dann besser als weitere Installationsversuche.

Wenn es weiter fehlschlägt

Verwandte Guides

• SageAttention in Windows ComfyUI installieren
• Triton fehlt oder ist in ComfyUI nicht verfügbar
• ComfyUI Plugin-Import fehlgeschlagen
• ComfyUI Dependency-Konflikte
• ComfyUI startet nicht

Quellen

• 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