Fehler beheben: ModuleNotFoundError und No module named in ComfyUI
Diagnostizieren und beheben Sie ModuleNotFoundError und No module named Fehler in ComfyUI basierend auf Paketnamen, Python-Umgebung, Custom Nodes und CUDA/PyTorch.
Wenn ComfyUI die Fehlermeldung ModuleNotFoundError: No module named ... ausgibt, dient diese Seite als zentraler Einstiegspunkt für die Fehlerdiagnose. Wenn Sie den Namen des fehlenden Moduls bereits kennen, springen Sie bitte direkt zu den entsprechenden Spezialseiten unten.
Das wichtigste Kriterium bei der Installation fehlender Python-Pakete ist: In welcher Python-Umgebung wird ComfyUI ausgeführt?
Für die offizielle Windows Portable-Version müssen Sie Befehle über die eingebettete Python-Version ausführen:
.\python_embeded\python.exe -s -m pip install <paketname>Bei manuellen Git-Installationen aktivieren Sie das entsprechende virtuelle Environment (venv) und führen Sie aus:
python -m pip install <paketname>Related errors
Schnelldiagnose
| Meldung im Startprotokoll | Wahrscheinliche Ursache | Erste Prüfung |
|---|---|---|
ModuleNotFoundError verweist auf custom_nodes | Abhängigkeit einer Custom Node fehlt | requirements.txt im Ordner des Plugins prüfen |
ModuleNotFoundError verweist auf ComfyUI\comfy\... | Core-Abhängigkeit von ComfyUI fehlt oder Version weicht ab | requirements.txt im ComfyUI-Hauptordner prüfen |
pip install war erfolgreich, aber der Fehler bleibt | Paket wurde in der falschen Python-Umgebung installiert | pip show <paketname> mit dem Python-Pfad von ComfyUI ausführen |
| Nach dem Neustart ändert sich das fehlende Modul | Der erste Fehler wurde behoben, nun wird der nächste blockierende Fehler sichtbar | Fahren Sie mit der Behebung des neuen ersten Fehlers fort |
| CUDA-, DLL- oder Wheel-Fehler treten auf | Das Paket hat native Abhängigkeiten oder GPU-Bindungen | Überprüfen Sie PyTorch und CUDA vor weiteren Änderungen |
Häufig fehlende Module
Folgende Module fehlen laut Telemetrie- und Support-Daten am häufigsten:
| Fehlendes Modul | Verwendung / Kontext | Spezialseite zur Behebung |
|---|---|---|
triton | FLUX, Beschleunigungsstapel, spezielle Sampler | Triton-Fehler beheben |
sageattention | Wan-Video-Bildratengenerierung und Beschleunigung | SageAttention-Fehler beheben |
onnx / onnxruntime | DWPose, Gesichtsanalyse, ReActor und IP-Adapter | ONNX und ONNXRuntime beheben |
llama_cpp | GGUF-Prompts, lokale LLM- / VLM-Kopplungen | llama_cpp-Fehler beheben |
insightface | Gesichtstausch (ReActor), InstantID | InsightFace-Fehler beheben |
cv2 | Bild- und Videobearbeitung, OpenCV-Bildlade-Nodes | cv2-Fehler beheben |
nunchaku | Nunchaku-quantisierte FLUX/Qwen/SANA-Workflows | nunchaku-Fehler beheben |
kornia | Interne Nachbearbeitung, Canny-Filter und Morphologie | kornia-Fehler beheben |
spandrel | Laden von Upscale-Modellen (nodes_upscale_model.py) | spandrel-Fehler beheben |
simpleeval | Mathematische Ausdrücke (nodes_math.py) | simpleeval-Fehler beheben |
pydantic_settings | Analyse von Einstellungsdateien | pydantic_settings-Fehler beheben |
yaml / PIL | Falscher Paketname beim Installieren: Verwenden Sie PyYAML / Pillow | yaml beheben oder PIL beheben |
safetensors | Python-Bibliothek zum Einlesen von Safetensors-Modellen | safetensors beheben |
einops | Tensor-Transformationen, ControlNet und Core-Modellstrukturen | einops-Fehler beheben |
scipy | Wissenschaftliche Berechnungen, Audio- und Video-Nodes | scipy-Fehler beheben |
torchsde | Stochastische Differentialgleichungs-Sampler (KSampler) | torchsde-Fehler beheben |
av | PyAV zur Videodekodierung und -kodierung | av-Fehler beheben |
aiohttp / requests | Netzwerkkommunikation und API-Anfragen | aiohttp beheben oder requests beheben |
Diskrepanz zwischen Importname und PyPI-Paketname
Achten Sie darauf, dass der Name, den Sie in Python importieren, nicht immer dem Paketnamen bei pip install entspricht. Folgende Tabelle zeigt häufige Sonderfälle:
| Importname (im Fehlerprotokoll) | Tatsächlicher Paketname | Installationsbefehl |
|---|---|---|
cv2 | opencv-python-headless | pip install opencv-python-headless |
yaml | PyYAML | pip install PyYAML |
PIL | Pillow | pip install Pillow |
segment_anything | segment-anything | pip install segment-anything |
llama_cpp | llama-cpp-python | pip install llama-cpp-python |
Relevante Leitfäden
Wenn dieses Problem deine echte ComfyUI-Umgebung betrifft, starte kostenlos mit Wonderful Launcher. Reparaturfluss, Aufgabenlogs und Laufzeitprüfungen bleiben im Launcher an einem Ort; Credits sind für Bildgenerierung und messbare Tools.
Wonderful Launcher herunterladenCredit-Pakete ansehenDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.