ComfyUI Manager: installare i nodi, riparare i erreurs

#A cosa serve ComfyUI Manager

Di base, ComfyUI sa fare solo ciò che consentono i suoi nodi integrati. Tutto il resto — ControlNet avanzato, preprocessori, upscaler, strumenti video e nodi di utilità — proviene da estensioni chiamate custom node. Ogni custom node è un repository Git contenente codice Python, collocato nella cartella custom_nodes della tua installazione e caricato all’avvio.

Senza Manager, installare un’estensione significa clonare manualmente un repository, installare le relative dipendenze Python nell’ambiente corretto e poi riavviare. Il Manager esegue questi passaggi da una finestra dell’interfaccia. Offre soprattutto tre funzioni che prima o poi si usano sempre: il rilevamento dei node mancanti in un workflow, un pulsante di riparazione per i node che rifiutano di caricarsi e gli snapshot per tornare indietro dopo un aggiornamento problematico.

Gestore dei nodi personalizzati

Il catalogo: ricerca, installazione, aggiornamento, disattivazione e disinstallazione delle estensioni indicizzate.

Install Missing Custom Nodes

Analizza il workflow aperto ed elenca le estensioni mancanti che spiegano la presenza dei nodi rossi.

Model Manager

Scarica modelli noti direttamente nella sottocartella corretta di models.

Update All

Aggiorna tutte le estensioni installate in una volta sola. È pratico, ma è anche il comando che più spesso compromette un'installazione funzionante.

Snapshot Manager

Salva lo stato dell'installazione (versione di ComfyUI, estensioni, pacchetti Python) per poterlo ripristinare.

#Prerequisito: sapere dove si trova la cartella custom_nodes

Il Manager, come ogni estensione, si trova nella cartella custom_nodes. La sua posizione dipende dal modo in cui hai installato ComfyUI e metà dei problemi di «node installato ma assente» deriva da un'estensione inserita nella cartella sbagliata o da dipendenze installate nel Python sbagliato.

ComfyUI Desktop

La cartella di base è quella che hai scelto durante l'installazione (spesso una cartella ComfyUI nei tuoi Documenti). Contiene custom_nodes, models, input e output. L'ambiente Python è gestito dall'applicazione, in una cartella .venv accanto.

Versione portabile per Windows

Nell’archivio decompresso: ComfyUI_windows_portable/ComfyUI/custom_nodes. Il Python dedicato è ComfyUI_windows_portable/python_embeded, ed è quello da usare per installare le dipendenze, mai il Python di sistema.

Installazione manuale (git clone)

ComfyUI/custom_nodes, con l'ambiente virtuale che hai creato per ComfyUI. Attivalo prima di qualsiasi comando pip.

In ogni caso

Git deve essere installato e accessibile: Manager clona i repository usandolo. Su Windows, verifica con git --version in un terminale.

Se ComfyUI non è ancora installato, inizia dalla guida all’installazione di ComfyUI, che confronta le versioni Desktop, portable e l’installazione manuale. Questa guida presuppone un’installazione che genera già un’immagine.

#Installa ComfyUI Manager in base alla tua versione

Esistono tre situazioni, e la prima è la più frequente nel 2026: il Manager è già presente. Prima di installare qualsiasi cosa, verifica che nella barra superiore dell’interfaccia sia presente un pulsante Manager.

#Caso 1: è già incluso (Desktop, comfy-cli)

L'applicazione ComfyUI Desktop include il Manager. Lo stesso vale per un'installazione eseguita con lo strumento a riga di comando comfy-cli, che lo aggiunge per impostazione predefinita. Se il pulsante Manager compare nella parte superiore dell'interfaccia, non devi fare nulla: passa alla sezione successiva.

#Caso 2: ComfyUI recente, Manager integrato ma disattivato

Il repository principale di ComfyUI ora integra il Manager come dipendenza facoltativa. Non si attiva da solo: devi installare il file manager_requirements.txt presente nella radice di ComfyUI, poi avviare il server con l'opzione --enable-manager. È il percorso da preferire per una recente installazione manuale, perché in questo modo il Manager segue la versione prevista dal tuo ComfyUI.

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

Per non dover digitare l'opzione ogni volta, aggiungila allo script di avvio o al tuo servizio. Nella versione portable, va inserita alla fine della riga di comando del file run_nvidia_gpu.bat (o dell'equivalente AMD o Intel).

#Caso 3: installazione classica in custom_nodes

È il metodo storico, ancora documentato nel repository del Manager, e l'unico possibile su una versione di ComfyUI che non contiene il file manager_requirements.txt. Si clona il repository in custom_nodes, poi si riavvia completamente ComfyUI.

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

Al riavvio, leggi il terminale. Una riga che menziona ComfyUI-Manager seguita dal numero di versione conferma il caricamento. Se invece vedi IMPORT FAILED accanto al suo nome, le dipendenze non sono state installate nel Python corretto: ripeti il comando pip usando l'ambiente di ComfyUI.

#Aggiungere un custom node con il Manager

1. 01
   Apri il catalogo

   Fai clic su Manager nella barra superiore, poi su Custom Nodes Manager. Al primo avvio viene scaricato l'elenco delle estensioni referenziate, operazione che può richiedere alcuni secondi.
2. 02
   Cercare l'estensione

   Digita il suo nome o una parola chiave nel campo di ricerca. Le colonne indicano l'autore, la descrizione, il numero di stelle GitHub e, a seconda delle versioni, la data dell'ultimo aggiornamento. Verifica che l'autore corrisponda effettivamente al repository che ti è stato consigliato: i nomi simili sono frequenti.
3. 03
   Installare

   Fai clic su Install. Manager clona il repository in custom_nodes e installa le dipendenze elencate nel suo requirements.txt. Il terminale scorre durante l'operazione. Se l'estensione esiste nel Comfy Registry, Manager propone generalmente una versione pubblicata e numerata invece dell'ultima revisione Git: scegli la versione pubblicata, più stabile.
4. 04
   Riavviare

   Un banner ti invita a riavviare. Accetta. ComfyUI si riavvia, ricarica tutte le estensioni e il browser si riconnette. Aggiorna la pagina se l'interfaccia non torna da sola.
5. 05
   Verificare

   Fai doppio clic sulla tela e digita il nome di un nodo dell'estensione. Se appare nell'elenco, hai finito. Altrimenti, leggi la sezione sui nodi installati ma assenti.

Per gli script e le installazioni senza interfaccia, comfy-cli offre la stessa funzione dalla riga di comando: comfy node install seguito dal nome dell’estensione la installa nell’installazione attiva di ComfyUI. Il Manager e comfy-cli leggono la stessa cartella custom_nodes, quindi puoi usare entrambi.

#Nodi mancanti: il workflow si apre con nodi rossi

È il principale caso d'uso di Manager. Carichi un workflow trovato online o estratto da un'immagine e ComfyUI mostra una finestra con l'elenco dei tipi di nodi mancanti, oltre a blocchi rossi sulla tela. Il workflow usa estensioni che non hai.

1. 01
   Leggere l’elenco dei tipi mancanti

   La finestra di avviso mostra i nomi interni dei nodi. Annotali: aiutano a ritrovare l’estensione se il rilevamento automatico non riesce.
2. 02
   Avviare Install Missing Custom Nodes

   Nel menu Manager, questo pulsante confronta i nodi mancanti con il database delle estensioni note e mostra quelle che li forniscono. Selezionale e installale.
3. 03
   Riavviare e ricaricare il workflow

   Dopo il riavvio, riapri il file del workflow (oppure trascina di nuovo l'immagine). I nodi rossi dovrebbero aver ripreso il loro colore normale.
4. 04
   Gestire manualmente i residui

   Se un nodo continua a mancare, il rilevamento non ha trovato la sua estensione: non è referenziata, ha cambiato nome oppure l'autore ha rinominato il nodo. Cerca il nome interno del nodo nel repository o nel forum da cui proviene il workflow, poi installa l'estensione cercandone il nome nel catalogo.

Due problemi ricorrenti si presentano spesso. Il primo: un workflow che richiede un’estensione introvabile ovunque, tranne che tramite un link per il download diretto. Trattalo con diffidenza: è lo schema dei nodi contraffatti descritti più avanti. Il secondo: un nodo mancante che in realtà appartiene a ComfyUI, perché la tua versione è troppo vecchia. In questo caso, la soluzione è aggiornare ComfyUI, non installare nulla.

#Node installato ma assente: IMPORT FAILED, disattivato, cartella errata

L'estensione risulta installata in Manager, ma i suoi nodi non esistono nell'interfaccia. La diagnosi si svolge nel terminale all'avvio di ComfyUI: ogni estensione viene elencata con il relativo tempo di caricamento, e quelle che falliscono riportano la dicitura IMPORT FAILED seguita da un traceback Python. Questo traceback è l'unica informazione utile; copialo prima di chiedere aiuto.

IMPORT FAILED con ModuleNotFoundError

Manca una dipendenza Python. Nel Custom Nodes Manager, filtra per Import Failed e fai clic su Try fix: il Manager reinstalla le dipendenze dell'estensione. Se non funziona, installa manualmente il requirements.txt dell'estensione usando il Python di ComfyUI (python_embeded nella versione portable).

IMPORT FAILED con un errore di versione

L'estensione richiede una versione di un pacchetto (spesso torch, numpy, transformers) incompatibile con un'altra estensione o con ComfyUI. Devi scegliere: leggere le issue del repository, disattivare l'estensione meno utile oppure aspettare una correzione. Non forzare una versione di torch, altrimenti romperesti ComfyUI.

Estensione disattivata

Il Manager disattiva un'estensione aggiungendo il suffisso .disabled al nome della relativa cartella. ComfyUI la ignora completamente. Filtra per Disabled nel catalogo per riattivarla oppure rimuovi manualmente il suffisso.

Cartella sbagliata

Hai due installazioni (Desktop e portable, oppure due cloni) e l'estensione si trova nei custom_nodes dell'altra. Il percorso esatto della cartella caricata viene visualizzato nelle prime righe del terminale all'avvio.

Repository vuoto o troncato

Un clone interrotto lascia una cartella priva di codice. Elimina la cartella dell’estensione e reinstallala.

Quando ComfyUI stesso non si avvia più o l'interfaccia diventa instabile dopo un'installazione, la documentazione ufficiale per la risoluzione dei problemi consiglia di isolare il responsabile per dicotomia. Avvia innanzitutto ComfyUI senza alcuna estensione per confermare che il problema provenga effettivamente da un custom node.

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

Se in questo modo funziona tutto, sposta metà delle cartelle di custom_nodes in una cartella a parte, riavvia e ripeti con la metà rimanente finché non avrai isolato l’estensione difettosa. Con dieci estensioni bastano quattro riavvii. Poi disinstallala dal Manager e segnala il problema nel suo repository, includendo il log del terminale.

#Errori di registro: la lista dei node non si carica

Il Manager non memorizza il catalogo sul tuo computer: all'apertura scarica un elenco di estensioni dal repository del Manager e, per le estensioni pubblicate, interroga il Comfy Registry, il repository ufficiale di Comfy Org dove gli autori pubblicano versioni numerate. Quando questo recupero non va a buon fine, il catalogo rimane vuoto, l'installazione di un node non finisce mai oppure un messaggio segnala un errore nel caricamento dell'elenco.

Nessun accesso alla rete dal server

Il Manager scarica dalla macchina che esegue ComfyUI, non dal tuo browser. Su un server remoto o in un container, verifica che abbia accesso a Internet (proxy, firewall, DNS). Un test curl verso github.com da questa macchina elimina ogni dubbio.

Modalità database

Nella finestra del Manager, un selettore DB permette di passare dal canale remoto a una copia locale dell'elenco. La modalità locale permette di continuare a lavorare con le estensioni già note quando GitHub non è accessibile; non vedrà quelle aggiunte da allora.

Canal

Il Manager propone diversi canali per gli elenchi (default, recent, legacy, dev, tra gli altri). Se un'estensione non compare, torna al canale default prima di cercare altrove; gli altri canali servono per le estensioni obsolete o sperimentali.

Limiti dell'API di GitHub

Dopo numerose richieste, GitHub può rifiutare temporaneamente le chiamate anonime. Attendi qualche minuto invece di riprovare in continuazione.

Azione rifiutata dal livello di sicurezza

Se il Manager risponde che un’azione non è consentita con il livello di sicurezza attuale, non si tratta di un errore di rete: leggi la sezione seguente.

Ultima risorsa, sempre valida: l'installazione manuale con git clone in custom_nodes, seguita dal requirements.txt e da un riavvio. Il Manager riconoscerà poi l'estensione come installata e saprà aggiornarla.

#Individuare un’estensione rischiosa prima di attivarla

Un custom node è codice Python eseguito all'avvio di ComfyUI, con i privilegi dell'utente che avvia il server: può leggere i tuoi file, i token delle sessioni del browser, i tuoi portafogli e accedere a Internet. Non è un'ipotesi teorica. Nel gennaio 2026, il repository ufficiale di ComfyUI ha documentato una serie di nodi pubblicati nel Comfy Registry con il nome «Upscaler_4K», che installavano un infostealer mirato a browser, portafogli di criptovalute e token Discord. Nell'aprile 2026, una campagna descritta da Censys prendeva di mira le istanze di ComfyUI esposte su Internet sfruttando custom nodes che eseguono codice senza autenticazione.

Il Manager integra una protezione: un livello di sicurezza, impostato dalla chiave security_level del suo file config.ini. Il repository del Manager documenta quattro valori: strong, normal (valore predefinito), normal- e weak. Il livello predefinito blocca le azioni più rischiose, come l'installazione da un URL Git arbitrario o l'installazione di pacchetti pip su richiesta, e le restrizioni diventano più severe quando ComfyUI viene avviato con --listen su un indirizzo non locale. Il livello weak rimuove tutte le barriere: attivalo solo per il tempo necessario a un'operazione precisa, su una macchina che non ascolta sulla rete, poi torna a normal. La griglia esatta delle azioni consentite per livello è riportata nel README del Manager, che fa fede in caso di dubbi.

Passare dal catalogo, non da un link

Le estensioni del catalogo e del Registry sono almeno identificate e possono essere rimosse in caso di segnalazione. Un link per il download diretto o un repository senza cronologia non lo è.

Guarda l'autore, la cronologia e le stelle

Un repository creato la settimana scorsa, con due commit, nessuna issue e un nome che imita un'estensione nota è il profilo tipico di un nodo trappola. Le stelle da sole non dimostrano nulla, ma un'estensione realmente utilizzata ne ha, così come ha issue aperte.

Diffidare delle promesse

Upscaler miracoloso, modello commerciale «sbloccato», workflow che richiede un’unica estensione introvabile altrove: rifiuta per impostazione predefinita.

Leggere il requirements.txt

Prima di installare un'estensione sconosciuta, apri il suo repository e leggi l'elenco delle dipendenze. Pacchetti senza rapporto con le immagini (accesso al browser, rete a basso livello, compressione di archivi esotici) sono un campanello d'allarme.

Non esporre mai ComfyUI senza protezione

Senza --listen, ComfyUI ascolta solo su 127.0.0.1. Se devi esporlo sulla rete, metti davanti un reverse proxy con password o una VPN e mantieni security_level su normal.

#Aggiornare senza rompere tutto

L’aggiornamento è la seconda causa di problemi dopo l’installazione. ComfyUI evolve rapidamente, le estensioni rimangono indietro e Update All applica tutto in una volta. Tre abitudini evitano di perdere una mattinata.

1. 01
   Creare prima un'istantanea

   Snapshot Manager, poi Save snapshot. Il Manager salva la revisione di ComfyUI, quella di ogni estensione e l'elenco dei pacchetti Python nella sua cartella snapshots. Se l'aggiornamento danneggia un workflow, Restore riporta tutto a questo stato dopo il riavvio.
2. 02
   Aggiornare un'estensione alla volta

   Nel catalogo, filtra per Update e aggiorna prima l'estensione che ti serve. Testa il workflow interessato. Update All resta utile su un'installazione semplice, ma dopo uno snapshot.
3. 03
   Aggiornare ComfyUI separatamente

   Il pulsante Update ComfyUI aggiorna il nucleo. Usalo quando un'estensione lo richiede, non per riflesso: ogni aggiornamento del nucleo può rompere le estensioni non mantenute; lo stesso README di ComfyUI avverte che gli ultimi commit possono romperne molte.

Su ComfyUI Desktop, il core viene aggiornato dall'applicazione e segue la versione stabile; qui il Manager serve solo per le estensioni. La versione portatile e l'installazione manuale, che seguono gli ultimi commit, hanno nello snapshot l'unica rete di sicurezza. Un workflow funzionante vale più di una versione più recente.

#Per approfondire

Il Manager risolve i problemi delle estensioni, ma non sostituisce la comprensione del grafo. Le guide seguenti coprono il resto della procedura, dall’installazione di ComfyUI agli utilizzi che richiedono custom node.

• ComfyUI: installazione e primi passi in locale
• ControlNet: comporre le proprie immagini, l'uso tipico dei custom nodes
• Generare immagini in locale: panoramica degli strumenti
• Fooocus: l'alternativa senza nodi né estensioni

Fonti ufficiali consultate per questa guida: la pagina del Manager e quella sull’installazione dei custom node nella documentazione di ComfyUI, la pagina per la risoluzione dei problemi dei custom node e il README del repository ComfyUI-Manager per i livelli di sicurezza. Le etichette dei menu citate corrispondono all’interfaccia del Manager descritta in queste pagine; possono variare da una versione all’altra.

• Documentazione di ComfyUI: l'interfaccia di Manager
• Documentazione di ComfyUI: installare un custom node
• Documentazione di ComfyUI: risoluzione dei problemi dei custom node
• Repository ComfyUI-Manager (README, livelli di sicurezza)