No module named-Fehler in ComfyUI beheben

Diagnostiziere ComfyUI ModuleNotFoundError und No module named-Fehler nach Paketnamen, Python-Umgebung, Custom-Node-Abhängigkeit und CUDA- oder PyTorch-Mismatch.

Wenn ComfyUI ModuleNotFoundError: No module named ... ausgibt, ist das fehlende Python-Paket nur ein Teil der Diagnose. Die wichtigere Frage lautet: Welche Python-Umgebung hat ComfyUI gestartet?

Für das offizielle Windows-Portable-Paket müssen Paketbefehle meist über dieses Python laufen:

.\python_embeded\python.exe -s -m pip ...

Für eine manuelle Git-Installation aktivierst du zuerst genau die venv, mit der ComfyUI startet, und benutzt dann:

python -m pip ...

Schnelldiagnose

Was im Log steht	Wahrscheinlichste Ursache	Erster Check
`ModuleNotFoundError` aus `custom_nodes`	Einer Custom Node fehlt eine Abhängigkeit	Plugin-Ordner und `requirements.txt` prüfen
`ModuleNotFoundError` aus `ComfyUI\comfy\...`	Eine Core-Abhängigkeit von ComfyUI fehlt oder ist verrutscht	Lokale `ComfyUI\requirements.txt` prüfen
`pip install` läuft durch, Fehler bleibt aber	In das falsche Python installiert	`pip show` mit ComfyUI-Python ausführen
Der Fehler ändert sich nach dem Neustart	Du hast den ersten Blocker behoben, jetzt kommt der nächste	Neue erste Traceback-Zeile lesen
CUDA-, DLL- oder Wheel-Fehler erscheinen	Das Paket hat native oder GPU-Abhängigkeiten	Vor weiteren Änderungen zuerst Torch/CUDA prüfen

Schritt 1: Das exakte fehlende Modul kopieren

Starte mit der konkreten Zeile aus dem Log, nicht mit einem geratenen Paketnamen:

ModuleNotFoundError: No module named 'sageattention'

Import-Name und PyPI-Paketname sind nicht immer identisch. cv2 kommt zum Beispiel meist aus einem OpenCV-Paket, segment_anything aus segment-anything.

Schritt 2: Herausfinden, welches Python ComfyUI wirklich startet

Für Windows Portable aus dem Paket-Root:

.\python_embeded\python.exe -s -m pip --version
.\python_embeded\python.exe -s -m pip show <package-name>

Für manuelle venv-Installationen:

python -m pip --version
python -m pip show <package-name>

Der ausgegebene Pfad muss in dieselbe ComfyUI-Umgebung zeigen. Wenn dort dein System-Python auftaucht, reparierst du gerade an der falschen Stelle.

Schritt 3: Entscheiden, ob das fehlende Paket wirklich kritisch ist

Nicht jedes fehlende optionale Beschleunigungspaket muss sofort repariert werden.

Fehlendes Modul	Oft kritisch?	Hinweis
`transformers` aus dem ComfyUI-Core	Ja	Tokenizer- und Modell-Stack können schon vor dem Start ausfallen
`torch`	Ja	Ohne funktionierendes PyTorch läuft ComfyUI nicht
`cv2`	Oft plugin-kritisch	Viele Vision-Custom-Nodes brauchen OpenCV
`sageattention`	Oft optional	Nur reparieren, wenn Workflow oder Launch-Flag es wirklich braucht
`onnxruntime`	Workflow-abhängig	Face-, Pose- und ONNX-basierte Nodes können es brauchen
`diffusers`	Plugin-abhängig	Meist eine Drittanbieter-Abhängigkeit

Schritt 4: Die gezielte Reparatur ausführen

Nutze die spezifische Anleitung, wenn es schon einen passenden Guide gibt:

Installiere nicht alle verwandten Pakete auf einmal. Starte nach jeder Reparatur neu und lies wieder den ersten echten Fehler.

Schritt 5: Die Reparatur prüfen

Bevor du ComfyUI neu startest, teste den Import im selben Python:

python -c "import <module_name>; print('import ok')"

Für Windows Portable:

.\python_embeded\python.exe -s -c "import <module_name>; print('import ok')"

Danach ComfyUI neu starten. Der ursprüngliche ModuleNotFoundError sollte verschwunden sein, und der betroffene Custom Node oder Workflow sollte laden. Wenn ein neues Paket fehlt, behandelst du genau dieses als nächsten ersten Blocker.

Wann Wonderful Launcher der bessere nächste Schritt ist

Manuelle Paket-Reparatur funktioniert gut, wenn genau ein klarer Import fehlt. Riskant wird es, wenn:

mehrere Custom Nodes schon beim Start scheitern
pip check nach jeder Änderung neue Konflikte meldet
Torch oder CUDA während der Reparatur mit verändert wurden
du nicht mehr sicher bist, welches Python ComfyUI überhaupt gestartet hat
der Workflow wichtig ist und du Modelle sowie Einstellungen erhalten willst

Still stuck after the manual fix?

Preserve the environment, collect the startup log, and use Wonderful Launcher diagnostics as the next step instead of trying random package installs.

Open diagnostics path

Related errors

Schnelldiagnose

Was im Log steht	Wahrscheinlichste Ursache	Erster Check
`ModuleNotFoundError` aus `custom_nodes`	Einer Custom Node fehlt eine Abhängigkeit	Plugin-Ordner und `requirements.txt` prüfen
`ModuleNotFoundError` aus `ComfyUI\comfy\...`	Eine Core-Abhängigkeit von ComfyUI fehlt oder ist verrutscht	Lokale `ComfyUI\requirements.txt` prüfen
`pip install` läuft durch, Fehler bleibt aber	In das falsche Python installiert	`pip show` mit ComfyUI-Python ausführen
Der Fehler ändert sich nach dem Neustart	Du hast den ersten Blocker behoben, jetzt kommt der nächste	Neue erste Traceback-Zeile lesen
CUDA-, DLL- oder Wheel-Fehler erscheinen	Das Paket hat native oder GPU-Abhängigkeiten	Vor weiteren Änderungen zuerst Torch/CUDA prüfen

Schritt 1: Das exakte fehlende Modul kopieren

Starte mit der konkreten Zeile aus dem Log, nicht mit einem geratenen Paketnamen:

ModuleNotFoundError: No module named 'sageattention'

Import-Name und PyPI-Paketname sind nicht immer identisch. cv2 kommt zum Beispiel meist aus einem OpenCV-Paket, segment_anything aus segment-anything.

Schritt 2: Herausfinden, welches Python ComfyUI wirklich startet

Für Windows Portable aus dem Paket-Root:

.\python_embeded\python.exe -s -m pip --version
.\python_embeded\python.exe -s -m pip show <package-name>

Für manuelle venv-Installationen:

python -m pip --version
python -m pip show <package-name>

Der ausgegebene Pfad muss in dieselbe ComfyUI-Umgebung zeigen. Wenn dort dein System-Python auftaucht, reparierst du gerade an der falschen Stelle.

Schritt 3: Entscheiden, ob das fehlende Paket wirklich kritisch ist

Nicht jedes fehlende optionale Beschleunigungspaket muss sofort repariert werden.

Fehlendes Modul	Oft kritisch?	Hinweis
`transformers` aus dem ComfyUI-Core	Ja	Tokenizer- und Modell-Stack können schon vor dem Start ausfallen
`torch`	Ja	Ohne funktionierendes PyTorch läuft ComfyUI nicht
`cv2`	Oft plugin-kritisch	Viele Vision-Custom-Nodes brauchen OpenCV
`sageattention`	Oft optional	Nur reparieren, wenn Workflow oder Launch-Flag es wirklich braucht
`onnxruntime`	Workflow-abhängig	Face-, Pose- und ONNX-basierte Nodes können es brauchen
`diffusers`	Plugin-abhängig	Meist eine Drittanbieter-Abhängigkeit

Schritt 4: Die gezielte Reparatur ausführen

Nutze die spezifische Anleitung, wenn es schon einen passenden Guide gibt:

Installiere nicht alle verwandten Pakete auf einmal. Starte nach jeder Reparatur neu und lies wieder den ersten echten Fehler.

Schritt 5: Die Reparatur prüfen

Bevor du ComfyUI neu startest, teste den Import im selben Python:

python -c "import <module_name>; print('import ok')"

Für Windows Portable:

.\python_embeded\python.exe -s -c "import <module_name>; print('import ok')"

Wann Wonderful Launcher der bessere nächste Schritt ist

Manuelle Paket-Reparatur funktioniert gut, wenn genau ein klarer Import fehlt. Riskant wird es, wenn:

mehrere Custom Nodes schon beim Start scheitern
pip check nach jeder Änderung neue Konflikte meldet
Torch oder CUDA während der Reparatur mit verändert wurden
du nicht mehr sicher bist, welches Python ComfyUI überhaupt gestartet hat
der Workflow wichtig ist und du Modelle sowie Einstellungen erhalten willst

Still stuck after the manual fix?

Preserve the environment, collect the startup log, and use Wonderful Launcher diagnostics as the next step instead of trying random package installs.

Open diagnostics path

No module named-Fehler in ComfyUI beheben

Related errors

Schnelldiagnose

Schritt 1: Das exakte fehlende Modul kopieren

Schritt 2: Herausfinden, welches Python ComfyUI wirklich startet

Schritt 3: Entscheiden, ob das fehlende Paket wirklich kritisch ist

Schritt 4: Die gezielte Reparatur ausführen

Schritt 5: Die Reparatur prüfen

Wann Wonderful Launcher der bessere nächste Schritt ist

Still stuck after the manual fix?

Verwandte Leitfäden

Inhaltsverzeichnis

No module named-Fehler in ComfyUI beheben

Related errors

Schnelldiagnose

Schritt 1: Das exakte fehlende Modul kopieren

Schritt 2: Herausfinden, welches Python ComfyUI wirklich startet

Schritt 3: Entscheiden, ob das fehlende Paket wirklich kritisch ist

Schritt 4: Die gezielte Reparatur ausführen

Schritt 5: Die Reparatur prüfen

Wann Wonderful Launcher der bessere nächste Schritt ist

Still stuck after the manual fix?

Verwandte Leitfäden

Inhaltsverzeichnis