ComfyUI Custom Nodes installieren, ohne ComfyUI zu beschädigen
Installiere ComfyUI Custom Nodes mit Manager oder manuellem Git Clone, vermeide Dependency-Drift und behebe rote Nodes, Importfehler oder Manager-Probleme sicher.
Wenn dieses Problem deine echte ComfyUI-Umgebung betrifft, starte mit Wonderful Launcher, prüfe den vorhandenen Rechner und nutze die Anleitung für die eigentliche Reparaturentscheidung.
Wonderful Launcher herunterladenGetestete Umgebung
- OS: Windows 10 / 11
- Launcher: Wonderful Launcher v1.x
- ComfyUI: Portable / Managed Install
- Python: 3.11+
- CUDA / Torch: CUDA 12.x / Torch 2.x
- Zuletzt geprüft: 2026-05-19
Wenn du ComfyUI Custom Nodes installieren willst, nimm für gängige Nodes zuerst den Manager. Einen manuellen Git Clone brauchst du vor allem dann, wenn du das exakte Repo bewusst kennst.
Custom Nodes sind Community-Plugins. Sie erweitern ComfyUI um Face Restore, Video-Generierung, Upscaling und vieles mehr. Sie sind aber auch eine der schnellsten Möglichkeiten, eine bis dahin funktionierende Umgebung zu beschädigen.
Wenn die Umgebung schon kaputt ist
Wenn du bereits Nodes installiert hast und ComfyUI danach nicht mehr sauber startet, gehe direkt zu Installed Custom Nodes and Broke ComfyUI?.
Schnellantwort
| Ziel | Bester erster Schritt |
|---|---|
| Einen gängigen Custom Node installieren | ComfyUI Manager im Toolbar-Menü verwenden |
| Ein Repo manuell von GitHub installieren | Nach ComfyUI/custom_nodes/ klonen und nur diese Requirements gezielt installieren |
| Rote Nodes in importierten Workflows reparieren | Manager-Flow für fehlende Nodes nutzen, dann neu starten und IMPORT FAILED prüfen |
| Torch, NumPy oder OpenCV nicht beschädigen | requirements.txt erst lesen, dann kleinsten nötigen Install ausführen |
Manager meldet failed to get custom node list | Den separaten Custom Node List Guide verwenden |
Methode 1: ComfyUI Manager
ComfyUI Manager ist heute die Standard-Schicht für Plugin-Verwaltung. In Desktop-Builds ist er meist bereits vorhanden. In neueren Portable- oder manuellen Installationen steckt er im Core, benötigt aber ggf. Dependencies und das Flag --enable-manager.
Desktop-Nutzer
ComfyUI Desktop bringt Manager in der Regel bereits aktiviert mit. App neu starten und in der Toolbar nach Manager suchen.
Neuere Portable-Nutzer
Vom Portable-Root aus:
.\python_embeded\python.exe -m pip install -r .\ComfyUI\manager_requirements.txt
.\python_embeded\python.exe -s .\ComfyUI\main.py --windows-standalone-build --enable-managerManuelle Installationen
In derselben venv, mit der ComfyUI startet:
python -m pip install -r manager_requirements.txt
python main.py --enable-managerLegacy-Fallback
Wenn dein Build noch die ältere Plugin-Installationsmethode braucht:
cd ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager.git comfyui-managerMit Manager kannst du dann:
- verfügbare Nodes durchsuchen
- Nodes per Klick installieren
- installierte Nodes updaten
- fehlende Nodes aus importierten Workflows nachinstallieren
Methode 2: Manueller Git Clone
- Terminal im Ordner
ComfyUI/custom_nodes/öffnen - Repo klonen:
cd ComfyUI/custom_nodes
git clone https://github.com/[author]/[node-name].git- Requirements nur dann installieren, wenn wirklich vorhanden, und nur im Python, das ComfyUI startet:
| Installationstyp | Sicherer Befehl |
|---|---|
| GitHub Windows Portable | .\python_embeded\python.exe -s -m pip install -r .\ComfyUI\custom_nodes\[node-name]\requirements.txt |
| Manuelle Git-Installation mit venv | python -m pip install -r custom_nodes/[node-name]/requirements.txt |
| ComfyUI Desktop / verwalteter Launcher | App-Terminal oder Environment-Tools verwenden |
- ComfyUI neu starten
Requirements niemals blind laufen lassen
Der riskanteste Schritt ist fast immer pip install -r requirements.txt. Prüfe vorher, ob das Plugin Torch, numpy, opencv-python, pillow oder andere Core-Pakete verändern will.
Methode 3: Einzelne Dateien kopieren
Einige einfache Nodes bestehen nur aus einer .py-Datei. Dann genügt:
ComfyUI/
+-- custom_nodes/
+-- my_node.pyDanach ComfyUI neu starten.
Beliebte Custom Nodes
| Node | Zweck |
|---|---|
| ComfyUI-Manager | andere Custom Nodes durchsuchen und installieren |
| ComfyUI-GGUF | GGUF-Modelle mit geringerem VRAM laden |
| ComfyUI-Impact-Pack | Face Detection, Segmentierung, Detailing |
| ComfyUI-AnimateDiff | Bilder zu kurzen Videos animieren |
| ComfyUI-IPAdapter | Referenzbilder für Stil und Struktur nutzen |
| ComfyUI-ControlNet | erweiterte ControlNet-Unterstützung |
Rote Nodes reparieren
Rote Nodes bedeuten, dass ComfyUI eine geforderte Backend-Node-Klasse nicht findet. Das hängt mit Plugins zusammen, ist aber nicht dasselbe wie ein bereits gelungener Plugin-Install.
Die Kette ist:
- Workflow verlangt eine Node-Klasse
- Plugin muss diese Klasse beim Start registrieren
- Registrierung klappt nur, wenn der Python-Import gelingt
- dieser Import kann von Paketen, Wheels, CUDA, Torch oder Plattform-Binaries abhängen
Also: Ein roter Node kann heißen "Plugin nicht installiert", aber auch "Plugin-Ordner ist da, Import ist trotzdem fehlgeschlagen".
Sicherere Installationsreihenfolge
Wenn dir die Umgebung wichtig ist, arbeite so:
- jeweils nur einen Node oder eine Node-Familie
- nach jeder Änderung ComfyUI neu starten
- das Startup-Log auf
IMPORT FAILEDprüfen - nicht mehrere
requirements.txthintereinander stacken - sofort stoppen, wenn Dependency-Drift sichtbar wird
Das wirkt langsamer, spart aber viel Zeit gegenüber einer späteren Komplettreparatur.
Troubleshooting
| Problem | Fix |
|---|---|
| Rote Nodes nach Workflow-Import | Fehlende Nodes via Manager oder manuell installieren |
| Node installiert, erscheint aber nicht | ComfyUI neu starten und IMPORT FAILED im Log prüfen |
ModuleNotFoundError beim Start | Fehlendes Paket in genau ComfyUIs Python installieren |
| Node-Konflikte oder Crashes | Ordner testweise umbenennen oder deaktivieren, siehe Dependency Conflicts |
| Manager lädt die Node-Liste nicht | GitHub-/Raw-GitHub-Zugriff, Cache und Proxy prüfen |
Verwandte Guides
- ComfyUI Failed to Get Custom Node List
- Installed Custom Nodes and Broke ComfyUI
- ComfyUI Plugin Import Failed
- ComfyUI Dependency Conflicts
Quellen
Wenn dieses Problem deine echte ComfyUI-Umgebung betrifft, starte mit Wonderful Launcher, prüfe den vorhandenen Rechner und nutze die Anleitung für die eigentliche Reparaturentscheidung.
Wonderful Launcher herunterladenWenn dieses Problem deine echte ComfyUI-Umgebung betrifft, starte mit Wonderful Launcher, prüfe den vorhandenen Rechner und nutze die Anleitung für die eigentliche Reparaturentscheidung.
Wonderful Launcher herunterladenDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.
No module named 'cv2' in ComfyUI: OpenCV-Fix
Behebe No module named 'cv2' in ComfyUI, fehlendes opencv-python-headless, opencv-contrib-python und Konflikte zwischen OpenCV-Paketen.
ComfyUI Plugin Import Failed: Custom-Node-Fehler beheben
Behebe ComfyUI plugin import failed, fehlende Custom Nodes, rote Workflow-Nodes und Dependency-Drift, ohne deine bestehende Umgebung neu aufzusetzen.