Fehler beheben: requirements.txt von ComfyUI Custom Nodes nicht installiert

Wenn eine ComfyUI Custom Node im Startprotokoll IMPORT FAILED aufgrund eines ModuleNotFoundError meldet, liegt dies meist daran, dass die requirements.txt der Node nie installiert wurde.

Das Klonen oder Herunterladen einer Custom Node in das Verzeichnis custom_nodes/ kopiert nur den Code. Die Python-Pakete, von denen dieser Code abhängt, müssen separat installiert werden.

In den 30 Tagen der Telemetriedaten von Wonderful Launcher bis zum 29. Juni 2026 trat die Fehlerbehebung für fehlende Abhängigkeiten wiederholt auf: Fälle von fehlenden Nodes, Klonversuchen, Installationsergebnissen und anschließenden ModuleNotFoundError-Ereignissen. Betrachten Sie diese als eine zusammenhängende Kette und nicht als isolierte Paketprobleme.

.\python_embeded\python.exe -s -m pip install -r ComfyUI\custom_nodes\<node-name>\requirements.txt
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build

Symptome des Fehlers

IMPORT FAILED: ComfyUI-ExampleNode
Traceback (most recent call last):
  File "...\custom_nodes\ComfyUI-ExampleNode\__init__.py", line 4, in <module>
    import somepackage
ModuleNotFoundError: No module named 'somepackage'

Der Ordner der Node befindet sich in custom_nodes/, aber der Import schlägt fehl, da somepackage nicht installiert ist.

Häufige Muster fehlender Module

Folgende Module treten in den Telemetriedaten häufig auf. Prüfen Sie diese nacheinander, bevor Sie dieselbe Node erneut klonen:

Wenn ein Modul nicht in der Liste steht, gilt die gleiche Regel: Finden Sie das fehlerhafte Plugin und installieren Sie die minimale Abhängigkeit in die Python-Umgebung, die ComfyUI ausführt.

Ursachen

• Manuelles git clone ohne pip install: Das Repository wurde geklont, aber die Installation der Abhängigkeiten wurde vergessen
• Unvollständige ComfyUI Manager-Installation: Der Manager hat das Repository geklont, aber die Installation der Abhängigkeiten schlug geräuschlos fehl
• Zurückgesetzte Umgebung: ComfyUI wurde neu installiert oder die Portable-Version aktualisiert, wodurch zuvor installierte Pakete gelöscht wurden
• In der falschen Python-Umgebung installiert: Die Abhängigkeiten wurden in der System-Python-Umgebung statt der integrierten Python-Umgebung von ComfyUI installiert
• Keine requirements.txt: Einige Nodes listen Abhängigkeiten nur im README auf und stellen keine requirements-Datei bereit

Schritt-für-Schritt-Fehlerbehebung

Schritt 1: Fehlerhafte Node identifizieren

Suchen Sie im ComfyUI-Startprotokoll nach Zeilen mit IMPORT FAILED. Diese Zeile zeigt Ihnen, welches Custom Node-Verzeichnis fehlgeschlagen ist und welches Modul fehlt.

Schritt 2: Vorhandensein der requirements.txt prüfen

Überprüfen Sie den Pfad mit:

dir ComfyUI\custom_nodes\<node-name>\requirements.txt

Wenn die Datei existiert, fahren Sie mit Schritt 3 fort. Andernfalls lesen Sie das README der Node auf GitHub für manuelle Installationsanweisungen.

Schritt 3: requirements-Datei vor der Installation prüfen

Lesen Sie die Datei aus:

type ComfyUI\custom_nodes\<node-name>\requirements.txt

Achten Sie auf folgende Risikosignale:

Wenn die Datei sicher erscheint, fahren Sie fort. Enthält die Datei torch oder andere Kernpakete, installieren Sie nur die tatsächlich fehlenden Pakete manuell, anstatt die gesamte Datei auszuführen.

Schritt 4: Abhängigkeiten installieren

Für die Windows Portable-Version:

.\python_embeded\python.exe -s -m pip install -r ComfyUI\custom_nodes\<node-name>\requirements.txt

Für ein manuell erstelltes venv:

python -m pip install -r custom_nodes/<node-name>/requirements.txt

Schritt 5: Bei Gefahren in der requirements-Datei (Manuelle Installation)

Anstatt alle Abhängigkeiten der Datei zu installieren, installieren Sie nur das fehlende Paket manuell:

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

Dies ist sicherer, wenn die requirements-Datei Kernpakete wie torch enthält.

Schritt 6: Verifizieren

Starten Sie ComfyUI neu und prüfen Sie, ob die IMPORT FAILED-Zeile verschwunden ist:

.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build

Relevante Leitfäden

• ComfyUI-Plugin-Import fehlgeschlagen
• ComfyUI-Abhängigkeitskonflikte
• Eine Custom Node hat die ComfyUI-Umgebung beschädigt
• Custom Nodes sicher installieren

Referenzen

• ComfyUI GitHub
• ComfyUI Dokumentation
• pip Dokumentation