ComfyUI Manager: Nodes installieren, reparieren erreurs

#Wozu dient ComfyUI Manager

ComfyUI kann standardmäßig nur das, was seine integrierten Nodes ermöglichen. Alles andere – fortgeschrittenes ControlNet, Präprozessoren, Vergrößerer, Video-Tools, Komfort-Nodes – stammt aus Erweiterungen, die als Custom Nodes bezeichnet werden. Jeder Custom Node ist ein Git-Repository mit Python-Code, das im custom_nodes-Ordner Ihrer Installation abgelegt und beim Start geladen wird.

Ohne Manager bedeutet die Installation einer Erweiterung, ein Repository manuell zu klonen, seine Python-Abhängigkeiten in der richtigen Umgebung zu installieren und anschließend neu zu starten. Der Manager erledigt diese Schritte über ein Fenster der Oberfläche. Vor allem bietet er drei Funktionen, die man letztlich immer nutzt: die Erkennung der Nodes, die in einem Workflow fehlen, eine Reparaturschaltfläche für Nodes, die das Laden verweigern, und Snapshots, um nach einem missglückten Update zurückzukehren.

Custom Nodes Manager

Der Katalog: Suche, Installation, Aktualisierung, Deaktivierung und Deinstallation der aufgelisteten Erweiterungen.

Install Missing Custom Nodes

Analysiert den geöffneten Workflow und listet die fehlenden Erweiterungen auf, die die roten Nodes erklären.

Model Manager

Lädt bekannte Modelle direkt in den richtigen models-Unterordner herunter.

Update All

Aktualisiert alle installierten Erweiterungen auf einmal. Praktisch, aber dies ist auch der Befehl, der eine funktionierende Installation am häufigsten beschädigt.

Snapshot Manager

Speichert den Zustand der Installation (ComfyUI-Version, Erweiterungen, Python-Pakete), damit Sie dorthin zurückkehren können.

#Voraussetzung: Sie wissen, wo sich Ihr custom_nodes-Ordner befindet

Der Manager befindet sich wie jede Erweiterung im Ordner custom_nodes. Sein Speicherort hängt davon ab, wie Sie ComfyUI installiert haben, und die Hälfte der Probleme „Node installiert, aber nicht vorhanden“ entsteht durch eine Erweiterung im falschen Ordner oder durch Abhängigkeiten, die im falschen Python installiert wurden.

ComfyUI Desktop

Der Basisordner ist der Ordner, den Sie bei der Installation ausgewählt haben (oft ein ComfyUI-Ordner in Ihren Dokumenten). Er enthält custom_nodes, models, input und output. Die Python-Umgebung wird von der Anwendung in einem danebenliegenden Ordner .venv verwaltet.

Portable Version für Windows

Im entpackten Archiv: ComfyUI_windows_portable/ComfyUI/custom_nodes. Die integrierte Python-Version befindet sich unter ComfyUI_windows_portable/python_embeded; genau diese müssen Sie zur Installation von Abhängigkeiten verwenden, niemals die Python-Version des Systems.

Manuelle Installation (git clone)

ComfyUI/custom_nodes mit der virtuellen Umgebung, die Sie für ComfyUI erstellt haben. Aktivieren Sie sie vor jedem pip-Befehl.

In allen Fällen

Git muss installiert und zugänglich sein: Der Manager klont die Repositories damit. Unter Windows prüfen Sie dies mit git --version in einem Terminal.

Wenn ComfyUI noch nicht installiert ist, beginnen Sie mit dem ComfyUI-Installationsleitfaden, der Desktop, portable und manuelle Installation vergleicht. Dieser Leitfaden setzt eine Installation voraus, die bereits ein Bild erzeugt.

#ComfyUI Manager entsprechend Ihrer Version installieren

Es gibt drei Situationen, und die erste ist 2026 am häufigsten: Der Manager ist bereits vorhanden. Prüfen Sie zunächst, ob in der oberen Leiste der Oberfläche eine Manager-Schaltfläche vorhanden ist, bevor Sie irgendetwas installieren.

#Fall 1: bereits enthalten (Desktop, comfy-cli)

Die ComfyUI Desktop-Anwendung enthält den Manager. Das Gleiche gilt für eine Installation mit dem Kommandozeilenwerkzeug comfy-cli, das ihn standardmäßig hinzufügt. Wenn die Schaltfläche Manager oben in der Benutzeroberfläche erscheint, müssen Sie nichts tun: Fahren Sie mit dem nächsten Abschnitt fort.

#Fall 2: Aktuelles ComfyUI, integrierter, aber deaktivierter Manager

Das Haupt-Repository von ComfyUI integriert den Manager inzwischen als optionale Abhängigkeit. Er wird nicht automatisch aktiviert: Sie müssen die im Stammverzeichnis von ComfyUI vorhandene Datei manager_requirements.txt installieren und den Server anschließend mit der Option --enable-manager starten. Dies ist der bevorzugte Weg für eine aktuelle manuelle Installation, da der Manager dann der von Ihrer ComfyUI-Version erwarteten Version folgt.

cd ComfyUI
pip install -r manager_requirements.txt
python main.py --enable-manager

Damit Sie die Option nicht jedes Mal erneut eingeben müssen, fügen Sie sie Ihrem Startskript oder Ihrem Dienst hinzu. Bei der portablen Version steht sie am Ende der Befehlszeile in der Datei run_nvidia_gpu.bat (oder in deren AMD- bzw. Intel-Entsprechung).

#Fall 3: klassische Installation in custom_nodes

Dies ist die historische Methode, die weiterhin im Manager-Repository dokumentiert ist, und die einzige Möglichkeit bei einer ComfyUI-Version ohne die Datei manager_requirements.txt. Klonen Sie das Repository in custom_nodes und starten Sie ComfyUI anschließend vollständig neu.

cd ComfyUI/custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
# puis arrêter ComfyUI (Ctrl+C) et le relancer
cd ..
python main.py

cd ComfyUI\custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
cd ..\..
.\python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt
# puis relancer run_nvidia_gpu.bat

Lesen Sie beim Neustart das Terminal. Eine Zeile, in der ComfyUI-Manager gefolgt von seiner Versionsnummer erwähnt wird, bestätigt das Laden. Wenn stattdessen neben seinem Namen IMPORT FAILED angezeigt wird, wurden die Abhängigkeiten nicht im richtigen Python installiert: Führen Sie den pip-Befehl mit der ComfyUI-Umgebung erneut aus.

#Einen Custom Node mit dem Manager hinzufügen

1. 01
   Katalog öffnen

   Klicken Sie in der oberen Leiste auf Manager und anschließend auf Custom Nodes Manager. Beim ersten Öffnen wird die Liste der erfassten Erweiterungen heruntergeladen, was einige Sekunden dauern kann.
2. 02
   Erweiterung suchen

   Geben Sie seinen Namen oder ein Stichwort in das Suchfeld ein. Die Spalten zeigen den Autor, die Beschreibung, die Anzahl der GitHub-Sterne und je nach Version das Datum der letzten Aktualisierung. Prüfen Sie, ob der Autor tatsächlich dem empfohlenen Repository entspricht: Ähnliche Namen sind häufig.
3. 03
   Installieren

   Klicken Sie auf Install. Der Manager klont das Repository nach custom_nodes und installiert die in seiner requirements.txt aufgeführten Abhängigkeiten. Während des Vorgangs läuft Text im Terminal durch. Falls die Erweiterung in der Comfy Registry vorhanden ist, bietet der Manager in der Regel eine veröffentlichte Version mit Versionsnummer statt der neuesten Git-Revision an: Nehmen Sie die veröffentlichte Version, sie ist stabiler.
4. 04
   Neu starten

   Ein Banner fordert Sie zum Neustart auf. Bestätigen Sie. ComfyUI wird neu gestartet, lädt alle Erweiterungen neu und der Browser verbindet sich erneut. Aktualisieren Sie die Seite, wenn die Benutzeroberfläche nicht von selbst zurückkehrt.
5. 05
   Prüfen

   Doppelklicken Sie auf die Arbeitsfläche und geben Sie den Namen eines Nodes der Erweiterung ein. Wenn er in der Liste erscheint, sind Sie fertig. Andernfalls lesen Sie den Abschnitt über installierte, aber nicht vorhandene Nodes.

Für Skripte und Installationen ohne Oberfläche deckt comfy-cli denselben Bedarf über die Befehlszeile ab: comfy node install gefolgt vom Namen der Erweiterung installiert sie in der aktiven ComfyUI-Installation. Manager und comfy-cli lesen denselben custom_nodes-Ordner; Sie können beide kombinieren.

#Fehlende Nodes: Der Workflow wird mit roten Knoten geöffnet

Das ist der wichtigste Anwendungsfall des Managers. Sie laden einen online gefundenen oder aus einem Bild extrahierten Workflow, und ComfyUI zeigt ein Fenster mit fehlenden Node-Typen sowie roten Blöcken auf der Arbeitsfläche an. Der Workflow verwendet Erweiterungen, die Sie nicht haben.

1. 01
   Die Liste der fehlenden Typen lesen

   Das Warnfenster nennt die internen Namen der Nodes. Notieren Sie sie: Sie helfen dabei, die Erweiterung zu finden, falls die automatische Erkennung fehlschlägt.
2. 02
   Install Missing Custom Nodes starten

   Diese Schaltfläche im Manager-Menü gleicht die fehlenden Nodes mit der Datenbank bekannter Erweiterungen ab und zeigt die Erweiterungen an, die sie bereitstellen. Wählen Sie sie aus und installieren Sie sie.
3. 03
   Neustarten und den Workflow neu laden

   Öffnen Sie nach dem Neustart die Workflow-Datei erneut (oder ziehen Sie das Bild noch einmal hinein). Die roten Nodes sollten wieder ihre normale Farbe haben.
4. 04
   Übrig gebliebene Reste manuell bearbeiten

   Wenn ein Node weiterhin fehlt, hat die Erkennung seine Erweiterung nicht gefunden: Sie ist nicht erfasst, wurde umbenannt oder der Node wurde von seinem Autor umbenannt. Suchen Sie den internen Namen des Nodes in dem Repository oder Forum, aus dem der Workflow stammt, und installieren Sie die Erweiterung unter ihrem Namen im Katalog.

Zwei Fallen treten häufig auf. Die erste: ein Workflow, der eine Erweiterung verlangt, die nirgendwo außer über einen direkten Download-Link zu finden ist. Seien Sie dabei misstrauisch; das entspricht dem weiter unten beschriebenen Muster manipulierter Nodes. Die zweite: ein fehlender Node, der in Wirklichkeit zu ComfyUI selbst gehört, weil Ihre Version zu alt ist. In diesem Fall besteht die Lösung darin, ComfyUI zu aktualisieren, nicht irgendetwas zu installieren.

#Node installiert, aber nicht vorhanden: IMPORT FAILED, deaktiviert, falscher Ordner

Die Erweiterung erscheint im Manager als installiert, aber ihre Nodes sind in der Benutzeroberfläche nicht vorhanden. Die Diagnose erfolgt im Terminal beim Start von ComfyUI: Jede Erweiterung wird dort mit ihrer Ladezeit aufgelistet, und bei fehlgeschlagenen Erweiterungen steht IMPORT FAILED gefolgt von einem Python-Trace. Dieser Trace ist die einzige nützliche Information; kopieren Sie ihn, bevor Sie Hilfe suchen.

IMPORT FAILED mit ModuleNotFoundError

Eine Python-Abhängigkeit fehlt. Filtern Sie im Custom Nodes Manager nach Import Failed und klicken Sie auf Try fix: Der Manager installiert die Abhängigkeiten der Erweiterung erneut. Wenn dies fehlschlägt, installieren Sie die requirements.txt der Erweiterung manuell mit dem Python von ComfyUI (python_embeded bei der portablen Version).

IMPORT FAILED mit einem Versionsfehler

Die Erweiterung verlangt eine Version eines Pakets (häufig torch, numpy oder transformers), die mit einer anderen Erweiterung oder mit ComfyUI inkompatibel ist. Sie müssen abwägen: Lesen Sie die Issues des Repositorys, deaktivieren Sie die weniger nützliche Erweiterung oder warten Sie auf eine Fehlerbehebung. Erzwingen Sie keine torch-Version, sonst würden Sie ComfyUI beschädigen.

Erweiterung deaktiviert

Der Manager deaktiviert eine Erweiterung, indem er den Suffix .disabled an den Namen ihres Ordners anhängt. ComfyUI ignoriert sie dann vollständig. Filtern Sie im Katalog nach Disabled, um sie wieder zu aktivieren, oder entfernen Sie den Suffix manuell.

Falscher Ordner

Sie haben zwei Installationen (Desktop und portabel oder zwei Klone), und die Erweiterung befindet sich im custom_nodes-Ordner der anderen Installation. Der genaue Pfad des geladenen Ordners wird beim Start in den ersten Zeilen des Terminals angezeigt.

Leeres oder unvollständiges Repository

Ein unterbrochener Klon hinterlässt einen Ordner ohne Code. Löschen Sie den Erweiterungsordner und installieren Sie die Erweiterung erneut.

Wenn ComfyUI selbst nicht mehr startet oder die Benutzeroberfläche nach einer Installation instabil wird, empfiehlt die offizielle Fehlerbehebungsdokumentation, den Verursacher per Halbierung einzugrenzen. Starten Sie ComfyUI zunächst ohne jegliche Erweiterung, um zu bestätigen, dass das Problem tatsächlich von einem Custom Node verursacht wird.

python main.py --disable-all-custom-nodes

Wenn auf diese Weise alles funktioniert, verschieben Sie die Hälfte der custom_nodes-Ordner in einen separaten Ordner, starten Sie neu und wiederholen Sie den Vorgang mit der verbleibenden Hälfte, bis Sie die fehlerhafte Erweiterung isoliert haben. Bei zehn Erweiterungen reichen vier Neustarts aus. Deinstallieren Sie sie anschließend über den Manager und melden Sie das Problem mit dem Terminal-Trace in ihrem Repository.

#Registry-Fehler: Die Node-Liste wird nicht geladen

Der Manager speichert den Katalog nicht bei Ihnen: Beim Öffnen lädt er eine Liste von Erweiterungen aus dem Repository des Managers herunter und fragt für veröffentlichte Erweiterungen die Comfy Registry ab, das offizielle Repository von Comfy Org, in dem Autoren nummerierte Versionen veröffentlichen. Wenn dieser Abruf fehlschlägt, bleibt der Katalog leer, die Installation eines Nodes läuft endlos weiter oder eine Meldung weist auf einen Fehler beim Laden der Liste hin.

Kein Netzwerkzugriff vom Server

Der Manager lädt von der Maschine herunter, auf der ComfyUI ausgeführt wird, nicht von Ihrem Browser. Überprüfen Sie bei einem entfernten Server oder einem Container, dass dieser auf das Internet zugreifen kann (Proxy, Firewall, DNS). Ein curl-Test zu github.com von dieser Maschine aus beseitigt den Zweifel.

Datenbankmodus

Im Manager-Fenster können Sie mit einem DB-Auswahlschalter vom entfernten Kanal zu einer lokalen Kopie der Liste wechseln. Im lokalen Modus können Sie mit den bereits bekannten Erweiterungen weiterarbeiten, wenn GitHub nicht erreichbar ist; neu hinzugefügte Erweiterungen werden dort nicht angezeigt.

Canal

Der Manager bietet mehrere Listenkanäle an (default, recent, legacy, dev und weitere). Wenn eine Erweiterung nicht erscheint, wechseln Sie zunächst zum Kanal default, bevor Sie weiter suchen; die anderen Kanäle dienen alten oder experimentellen Erweiterungen.

GitHub-API-Limits

Nach zahlreichen Anfragen kann GitHub anonyme Aufrufe vorübergehend ablehnen. Warten Sie einige Minuten, statt die Anfrage in einer Schleife erneut zu senden.

Aktion aufgrund der Sicherheitsstufe abgelehnt

Wenn der Manager meldet, dass eine Aktion mit der aktuellen Sicherheitsstufe nicht zulässig ist, handelt es sich nicht um einen Netzwerkfehler: Lesen Sie den nächsten Abschnitt.

Als letzter Ausweg, aber weiterhin gültig: die manuelle Installation mit git clone in custom_nodes, gefolgt von der requirements.txt und einem Neustart. Der Manager erkennt die Erweiterung anschließend als installiert und kann sie aktualisieren.

#Eine riskante Erweiterung erkennen, bevor Sie sie aktivieren

Ein Custom Node ist Python-Code, der beim Start von ComfyUI mit den Rechten des Benutzers ausgeführt wird, der den Server startet: Er kann Ihre Dateien, Browser-Sitzungstoken und Wallets lesen und das Internet aufrufen. Das ist keine theoretische Gefahr. Im Januar 2026 dokumentierte das offizielle ComfyUI-Repository eine Reihe von Nodes, die unter dem Namen „Upscaler_4K“ in der Comfy Registry veröffentlicht worden waren und einen Datendieb installierten, der auf Browser, Kryptowährungs-Wallets und Discord-Token abzielte. Im April 2026 beschrieb Censys eine Kampagne gegen über das Internet erreichbare ComfyUI-Instanzen, bei der Custom Nodes ausgenutzt wurden, die ohne Authentifizierung Code ausführen.

Der Manager verfügt über eine Sicherheitsvorkehrung: eine Sicherheitsstufe, die über den Schlüssel security_level in seiner config.ini festgelegt wird. Das Manager-Repository dokumentiert vier Werte: strong, normal (Standardwert), normal- und weak. Die Standardstufe blockiert die riskantesten Aktionen, etwa die Installation von einer beliebigen Git-URL oder die bedarfsgesteuerte Installation von pip-Paketen; die Einschränkungen werden verschärft, wenn ComfyUI mit --listen auf einer nicht lokalen Adresse gestartet wird. Die Stufe weak hebt alle Schranken auf: Aktivieren Sie sie nur für die Dauer eines bestimmten Vorgangs auf einem Rechner, der nicht im Netzwerk lauscht, und wechseln Sie anschließend wieder zu normal. Die genaue Übersicht der je Stufe zulässigen Aktionen finden Sie in der README des Managers; diese ist im Zweifelsfall maßgeblich.

Den Katalog verwenden, nicht einen Link

Die Erweiterungen aus dem Katalog und der Registry sind zumindest identifizierbar und können bei einer Meldung entfernt werden. Ein direkter Download-Link oder ein Repository ohne Verlauf ist es nicht.

Autor, Verlauf und Sterne anzeigen

Ein Repository, das letzte Woche erstellt wurde, zwei Commits, keine Issues und ein Name, der eine bekannte Erweiterung imitiert – das ist das typische Profil eines manipulierten Nodes. Sterne allein beweisen nichts, aber eine tatsächlich verwendete Erweiterung hat welche und offene Issues.

Versprechen mit Vorsicht genießen

Wundervergrößerer, kommerzielles „entfesseltes“ Modell, Workflow, der eine einzige und sonst nirgendwo auffindbare Erweiterung verlangt: Lehnen Sie standardmäßig ab.

Die requirements.txt lesen

Öffnen Sie vor der Installation einer unbekannten Erweiterung ihr Repository und lesen Sie die Liste der Abhängigkeiten. Pakete ohne Bezug zur Bildverarbeitung (Browserzugriff, Low-Level-Netzwerkzugriff, exotische Archivkomprimierung) sind ein Warnsignal.

ComfyUI niemals ohne Schutz öffentlich zugänglich machen

Ohne --listen lauscht ComfyUI nur auf 127.0.0.1. Wenn Sie es im Netzwerk öffnen müssen, schalten Sie einen Reverse-Proxy mit Passwort oder ein VPN davor und belassen Sie security_level auf normal.

#Aktualisieren, ohne alles kaputtzumachen

Das Update ist nach der Installation die zweithäufigste Fehlerquelle. ComfyUI entwickelt sich schnell weiter, die Erweiterungen folgen mit Verzögerung, und „Update All“ wendet alles auf einmal an. Drei Gewohnheiten verhindern, dass Sie einen Vormittag verlieren.

1. 01
   Zuvor einen Snapshot erstellen

   Snapshot Manager und anschließend Save snapshot. Der Manager speichert die ComfyUI-Revision, die jeder Erweiterung sowie die Liste der Python-Pakete in seinem snapshots-Ordner. Wenn ein Update einen Workflow beschädigt, versetzt Restore nach einem Neustart alles wieder in diesen Zustand.
2. 02
   Erweiterungen einzeln aktualisieren

   Filtern Sie im Katalog nach Update und aktualisieren Sie zuerst die benötigte Erweiterung. Testen Sie den betreffenden Workflow. Update All bleibt bei einer einfachen Installation nützlich, aber erst nach einem Snapshot.
3. 03
   ComfyUI separat aktualisieren

   Die Schaltfläche Update ComfyUI aktualisiert den Kern. Tun Sie dies, wenn eine Erweiterung es erfordert, nicht aus Gewohnheit: Jede Aktualisierung des Kerns kann nicht gepflegte Erweiterungen beschädigen; auch die README von ComfyUI warnt selbst davor, dass die neuesten Commits viele davon beschädigen können.

Bei ComfyUI Desktop wird der Kern über die Anwendung aktualisiert und folgt der stabilen Version; der Manager dient dort nur den Erweiterungen. Bei der Portable-Version und der manuellen Installation, die den neuesten Commits folgen, ist der Snapshot Ihr einziges Sicherheitsnetz. Ein funktionierender Workflow ist mehr wert als eine neuere Version.

#Weiterführende Informationen

Der Manager behebt Probleme mit Erweiterungen; er ersetzt nicht das Verständnis des Graphen. Die folgenden Leitfäden behandeln den Rest der Kette, von der Installation von ComfyUI bis zu Anwendungen, die Custom Nodes erfordern.

• ComfyUI: Installation und erste Schritte auf dem eigenen Rechner
• ControlNet: Bilder komponieren – der typische Einsatz von Custom Nodes
• Bilder lokal generieren: Überblick über die Tools
• Fooocus: die Alternative ohne Nodes und Erweiterungen

Für diesen Leitfaden konsultierte offizielle Quellen: die Manager-Seite und die Seite zur Installation von Custom Nodes in der ComfyUI-Dokumentation, die Seite zur Fehlerbehebung bei Custom Nodes sowie die README des ComfyUI-Manager-Repositorys zu den Sicherheitsstufen. Die genannten Menübezeichnungen entsprechen der in diesen Seiten beschriebenen Manager-Oberfläche; sie können sich von Version zu Version unterscheiden.

• ComfyUI-Dokumentation: die Benutzeroberfläche des Managers
• ComfyUI-Dokumentation: einen Custom Node installieren
• ComfyUI-Dokumentation: Fehler bei Custom Nodes beheben
• ComfyUI-Manager-Repository (README, Sicherheitsstufen)