ComfyUI Dependency Conflicts ohne Neuinstallation beheben

Wenn du nach comfyui dependency conflicts, custom node broke environment oder pip install broke comfyui suchst, ist die Kurzantwort:

Nicht zuerst neu installieren. Finde erst heraus, welches Plugin oder welches Paket den gemeinsamen Python-Stack beschädigt hat, und repariere dann die kleinste mögliche Schicht.

Dependency-Konflikte sind der versteckte Killer vieler ComfyUI-Umgebungen. Ein Plugin installiert ein Paket, dieses Paket verändert PyTorch, NumPy, OpenCV oder eine andere gemeinsame Bibliothek, und plötzlich läuft ein Workflow nicht mehr, der gestern noch funktionierte.

Schnellantwort

Typische Konflikt-Signaturen

Neuere Support-Fälle zeigen: Nutzer suchen oft nicht nach dem abstrakten Begriff "Konflikt", sondern nach der exakten pip check-Zeile.

Die zentrale Regel bleibt gleich: Eine pip check-Zeile ist ein Hinweis, nicht automatisch ein Befehl.

Bevor du irgendetwas installierst

Mach zuerst diese vier Dinge:

1. Den exakten Startup-Fehler sichern
2. Das zuletzt installierte oder aktualisierte Plugin notieren
3. Prüfen, welches Python ComfyUI wirklich startet
4. Entscheiden, ob das ein Core-Runtime-Bruch, ein Plugin-Import-Bruch oder nur eine harmlose Warnung ist

Problemverständnis

ComfyUI-Plugins sind eigenständige Git-Repos mit jeweils eigener requirements.txt. Wenn du viele Plugins kombinierst, kollidieren deren Paketwünsche:

• ein Plugin will numpy>=2
• ein anderes funktioniert nur mit numpy<2
• ein Video-Node braucht neuere transformers
• ein Face- oder Pose-Node zieht ONNX Runtime oder OpenCV in einer heiklen Variante nach
• ein Acceleration-Paket erwartet eine ganz bestimmte Kombination aus Python, Torch, CUDA und GPU

Die wichtige Kette ist:

1. Ein Workflow verlangt Node-Klassen
2. Plugins registrieren diese Klassen beim Start
3. Diese Registrierung hängt an Python-Paketen und nativen Wheels
4. Diese Wheels hängen an Python, PyTorch, CUDA, cuDNN, GPU-Architektur und Windows-Runtime

Wenn du auf der falschen Ebene reparierst, wird die Umgebung schmutziger, während der ursprüngliche Fehler bleibt.

Schritt 1: Diagnostizieren

Importfehler prüfen

Suche im Startup-Log nach IMPORT FAILED:

IMPORT FAILED: ComfyUI-ExampleNode
ModuleNotFoundError: No module named 'somepackage'

Damit weißt du, welches Plugin kaputt ist und warum.

pip check im richtigen Python ausführen

Manager-Importfehler abrufen

Wenn ComfyUI noch läuft:

http://127.0.0.1:8188/v2/customnode/import_fail_info_bulk

Schritt 2: Einordnen, was wirklich kritisch ist

Harte Blocker

Diese Dinge reparierst du zuerst:

• Torch-Mismatch oder CPU-only-Torch
• ein fehlendes Paket, das ein wirklich benötigtes Plugin direkt importiert
• native Wheel-Importfehler wie DLL load failed while importing cv2
• zwei aktiv benötigte Plugins mit unvereinbaren Versionen desselben Kernpakets

Weiche Drift

Nicht jede pip check-Warnung muss sofort angefasst werden:

• pip check meldet Versionsabweichung, aber ComfyUI startet, Plugin importiert und Workflow läuft
• das Paket wird nur von einem Feature genutzt, das du gar nicht brauchst
• ein optionales Acceleration-Backend fehlt, aber es gibt einen stabilen Fallback

Faustregel: Wenn ComfyUI startet, das Plugin registriert und der Workflow läuft, repariere eine Warnung nicht nur, damit pip check sauber aussieht.

Schritt 3: Reparieren

Regel 1: Core-Runtime schützen

Diese Pakete dürfen nicht versehentlich von Plugin-Requirements umgeschrieben werden:

• torch / torchvision / torchaudio
• numpy
• pillow
• opencv-python / opencv-python-headless
• transformers / diffusers / huggingface-hub

Bevor du Plugin-Requirements installierst, prüfe was geändert würde:

python -m pip install -r requirements.txt --dry-run

Wenn die Dry-Run-Ausgabe Torch, NumPy, Pillow, OpenCV oder den Hugging-Face-Stack ersetzen will, stoppe und entscheide zuerst, ob dieses Plugin die Änderung wirklich wert ist.

Regel 2: Immer das richtige Python benutzen

pip install ohne Präfix ist riskant, weil du damit leicht ins falsche Python schreibst.

Regel 3: So klein wie möglich reparieren

Nicht sofort sowas ausführen:

python -m pip install -U transformers diffusers huggingface-hub

Nimm stattdessen den kleinsten Fix, der genau zu deinem ersten echten Fehler passt.

Regel 4: Paketnamen nicht verwechseln

Einige Fehler haben tückische Paketnamen:

Was Dependency-Konflikte meist schlimmer macht

Vermeide diese Reflexe:

• alte Reddit- oder Discord-Befehle blind ausführen
• plain pip install ins falsche Python
• Torch stillschweigend downgraden lassen
• NumPy, OpenCV, Transformers oder Diffusers als Gruppe anfassen, obwohl nur ein Plugin kaputt ist

Wie Wonderful Launcher hilft

Wonderful Launcher ist sinnvoll, sobald du nicht nur einen Einzelimport reparierst, sondern den ganzen Environment-Zustand stabil halten musst:

• Umgebungen lassen sich besser trennen
• Recovery läuft sauberer
• Modelle und Workflows bleiben erhalten
• du brauchst seltener einen Full Reset

Verwandte Guides

• ComfyUI Plugin Import Failed
• ComfyUI Startup Failed
• ComfyUI SageAttention Missing
• ComfyUI Triton Missing
• ComfyUI MMCV Install Failed

Quellen

• ComfyUI troubleshooting overview
• ComfyUI custom node troubleshooting guide
• ComfyUI model troubleshooting guide