ComfyUI: installazione e primi passi in locale (2026)

#Che cos'è ComfyUI?

ComfyUI è un software libero (licenza GPL-3.0), il cui repository è stato creato nel gennaio 2023 e che oggi è mantenuto dall'organizzazione Comfy Org; supera le 130.000 stelle su GitHub. Si installa sul tuo computer e si apre nel browser all'indirizzo http://127.0.0.1:8188. Il calcolo avviene sulla tua scheda grafica e il README specifica che il cuore del software non scarica nulla finché non lo richiedi.

La sua particolarità è mostrare la pipeline invece di nasconderla. Mentre un'interfaccia classica offre un campo di testo e un pulsante, ComfyUI mostra ogni fase sotto forma di nodo: caricare il modello, codificare il prompt, rimuovere il rumore, decodificare l'immagine, salvarla. Colleghi i nodi tramite collegamenti rappresentati da fili. L'insieme forma un workflow che si può salvare, condividere ed eseguire nuovamente in modo identico.

Il README annuncia una versione stabile di rilievo circa ogni due settimane. Questo dettaglio conta per l'installazione: l'applicazione Desktop segue per impostazione predefinita la versione stabile, mentre la versione portatile e l'installazione via Git seguono gli ultimi commit, che, avverte il README, possono compromettere il funzionamento di molte estensioni.

• Panoramica: tutte le modalità per generare immagini localmente

#L'hardware di cui hai bisogno

Come per un LLM, la memoria della scheda grafica determina tutto. ComfyUI attenua però questa regola: il suo README dichiara che anche i modelli aperti più grandi girano «relativamente velocemente» con 4 GB di VRAM e 8 GB di RAM, grazie al caricamento asincrono dei pesi. È una dichiarazione, non una misurazione: più i pesi eccedono la capacità della VRAM, più i trasferimenti di andata e ritorno richiedono tempo. La tabella parte quindi da ciò che è verificabile: le dimensioni dei file pubblicati su Hugging Face.

Quanto ai produttori, NVIDIA resta la scelta senza complicazioni. Le schede AMD funzionano bene su Linux con ROCm e, da gennaio 2026, lo stesso team di ComfyUI annuncia che il supporto ufficiale ROCm «is now available on the Windows ComfyUI Desktop app, starting with version v0.7.0», per le Radeon e i processori Ryzen AI compatibili. Prevedi infine spazio sul disco: un singolo modello pesa da 2 a 25 GB, e ne accumuli facilmente una decina.

• VRAM: cos'è e come verificare la tua
• Quale GPU scegliere per l'IA locale

#Tre modi per installarlo

git clone https://github.com/Comfy-Org/ComfyUI.git
cd ComfyUI
python -m venv venv && source venv/bin/activate

# PyTorch pour NVIDIA (commande du README) ; pour AMD, Intel ou Mac, suivre le README
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

pip install -r requirements.txt
python main.py

All'avvio, il terminale mostra l'indirizzo locale da aprire nel browser. Se il terminale segnala «Torch not compiled with CUDA enabled», il README indica di disinstallare torch (pip uninstall torch) e poi di reinstallarlo con il comando riportato sopra.

#Gestire la memoria: le opzioni che contano nel 2026

La gestione della VRAM è cambiata. Nel codice di ComfyUI, la «dynamic VRAM» è attivata per impostazione predefinita, a meno che tu non imposti --highvram, --novram o --cpu, oppure la disattivi con --disable-dynamic-vram; il testo di aiuto di --enable-dynamic-vram lascia intendere che su alcuni sistemi non sia attiva per impostazione predefinita. Il testo di aiuto di --lowvram è esplicito: l'opzione non fa nulla finché la VRAM dinamica è attiva. Il vecchio consiglio di aggiungere --lowvram su una scheda da 6 GB non si applica quindi più così com'è.

--reserve-vram X

Riserva X GB di VRAM per il sistema e gli altri programmi: utile se il computer viene usato anche per la visualizzazione a schermo o per un LLM.

--disable-dynamic-vram

Torna al caricamento classico basato su stime: da provare in caso di crash legato alla memoria.

--novram e --cpu

Ultime risorse: l'aiuto descrive --novram come l'opzione « quando lowvram non basta » e --cpu come « slow ». Aspettati una generazione nettamente più lenta.

--listen

Per impostazione predefinita ComfyUI ascolta solo su 127.0.0.1. Senza un argomento, --listen apre tutte le interfacce di rete: da usare solo su una rete fidata; vedi la sezione sulla sicurezza.

#Dove mettere i modelli

ComfyUI non include nessun modello. Questa è la principale causa di blocco: l'interfaccia si apre, si fa clic su Esegui e un errore segnala un file mancante. Ogni tipo di file ha la propria sottocartella nella cartella models.

models/checkpoints

I modelli 'in un solo file' come SDXL: un solo file .safetensors contiene il modello di diffusione, l'encoder di testo e il VAE. È il modo più semplice per iniziare.

models/diffusion_models

Il solo modello di diffusione, per le famiglie recenti distribuite in componenti separati (Flux, Z-Image, Wan).

models/text_encoders

L'encoder che trasforma il tuo prompt in vettori. Spesso il file più grande dopo il modello stesso.

models/vae

Il decoder che trasforma il risultato del calcolo in un'immagine visibile

models/loras

LoRA: piccoli file che aggiungono uno stile, un personaggio o un concetto a un modello base.

#Riutilizzare i modelli di un'altra interfaccia

Se hai già dei checkpoint con AUTOMATIC1111 o Fooocus, non è necessario copiarli. Il README fornisce un file extra_model_paths.yaml.example nella directory radice di ComfyUI: rinominalo in extra_model_paths.yaml, indica il percorso delle cartelle esistenti e ComfyUI li leggerà senza duplicarli. Nell'archivio portabile per Windows, questo file si trova nella cartella ComfyUI.

#La tua prima immagine

1. 01
   Caricare un workflow ufficiale

   Nel menu dei template di workflow, scegli la generazione di immagini di base adatta alla tua VRAM: SDXL a partire da 8 GB, un modello recente in FP8 a partire da 12 GB.
2. 02
   Scaricare i file proposti

   Accetta i download. Controlla nel terminale che si completino senza errori: un'interruzione di rete lascia un file troncato che causerà un errore difficile da interpretare in seguito.
3. 03
   Scrivere il prompt

   Il nodo di codifica del testo collegato all'ingresso «positive» contiene la descrizione dell'immagine. Quello collegato a «negative» elenca ciò che non vuoi vedere. La maggior parte dei modelli capisce meglio l'inglese.
4. 04
   Eseguire

   Clicca su Esegui. I nodi si accendono uno dopo l'altro. La prima generazione è lenta perché occorre caricare il modello nella VRAM; le successive sono molto più veloci.
5. 05
   Ritrovare l'immagine

   Viene visualizzata nel nodo di salvataggio e si trova nella cartella output. Il file PNG contiene l'intero workflow che l'ha generata.

Tre impostazioni del nodo di campionamento bastano per iniziare. Il seme (seed) determina l'immagine: lo stesso seme e le stesse impostazioni producono la stessa immagine. Il numero di passi (steps) regola il tempo di calcolo, da 20 a 30 per un modello classico, da 4 a 8 per un modello «turbo». Il CFG regola la fedeltà al prompt: se è troppo alto, l'immagine si satura e si deforma.

#Capire e recuperare i workflow

Un workflow è un semplice file JSON, e ComfyUI lo incorpora in ogni immagine che salva. Trascina nella finestra un PNG prodotto da ComfyUI e si ricarica il grafo completo che lo ha generato, con il prompt, il seed e tutte le impostazioni. La documentazione ufficiale lo presenta come uno dei due metodi di caricamento nel suo primo tutorial. È il modo migliore per imparare.

Quando un workflow recuperato mostra nodi rossi, utilizza estensioni che non hai. ComfyUI-Manager le elenca e le installa. Ora è integrato nel repository principale, ma rimane facoltativo: si attiva con l'opzione --enable-manager, dopo l'installazione di manager_requirements.txt. Non esagerare: cinquanta estensioni finiscono per compromettere un'installazione al primo aggiornamento.

#Nodi malevoli e istanze esposte: il rischio reale

L'avvertimento sul codice che viene eseguito non è teorico. Il 10 gennaio 2026, un'issue del repository ufficiale, intitolata « Malicious Distribution of Akira Stealer via 'Upscaler_4K' Custom Nodes in Comfy Registry », ha documentato una serie di nodi pubblicati sul Comfy Registry spacciandoli per un « Upscaler_4K ». La logica malevola, nascosta in una cartella di script per eludere gli scanner del registro, prendeva di mira su Windows i dati dei browser, i portafogli di criptovalute e i token Discord. L'issue riporta 779 possibili installazioni.

Secondo rischio, indipendente dalle estensioni del registro: l'esposizione su Internet. Ad aprile 2026, The Hacker News ha riportato, sulla base di un rapporto di Censys, una campagna diretta contro le istanze ComfyUI accessibili pubblicamente: ne erano state censite più di 1.000. Lo scanner sfrutta nodi personalizzati che eseguono codice senza autenticazione e, se ComfyUI-Manager è presente, installa esso stesso un nodo vulnerabile prima di riprovare. Le macchine compromesse minavano Monero e Conflux e alimentavano una botnet.

Prima di installare un'estensione

Usa ComfyUI-Manager anziché un link trovato su un forum, verifica il numero di installazioni e la data dell'ultimo aggiornamento ed evita qualsiasi nodo che prometta una scorciatoia troppo bella per essere vera (« upscaler magico », « sblocco delle restrizioni » di un modello commerciale).

Se utilizzi --listen

Non esporre mai ComfyUI su Internet senza un livello di autenticazione davanti: un reverse proxy con password o, meglio ancora, una VPN. Altrimenti, la tua macchina entra nell'elenco dei bersagli sottoposti a scansione automatica.

Per disattivare i servizi online

L'opzione --disable-api-nodes disattiva i nodi API a pagamento di Comfy e impedisce all'interfaccia di comunicare con Internet, secondo la guida della riga di comando.

• Fonte: la segnalazione ufficiale della campagna Akira Stealer
• Fonte: The Hacker News sulle istanze ComfyUI compromesse
• Fonte: l'annuncio del supporto ROCm ufficiale su Windows

#Gli errori dei primi giorni

Errore di memoria (CUDA out of memory)

Il modello o la risoluzione superano la tua VRAM. Riduci la dimensione dell'immagine, usa una versione FP8 o quantizzata, riserva spazio con --reserve-vram, o prova --disable-dynamic-vram.

Immagine nera o rumore colorato

Quasi sempre un VAE o un encoder di testo che non corrisponde al modello. Riparti dal workflow ufficiale della famiglia in questione.

Generazione interminabile

Controlla nel terminale che la GPU venga rilevata all'avvio. Se ComfyUI segnala un funzionamento su CPU, la versione di PyTorch installata non corrisponde alla tua scheda.

Torch not compiled with CUDA enabled

Disinstalla torch (pip uninstall torch), poi reinstallalo con il comando del README per la tua scheda.

Nodi rossi all'apertura di un workflow

Mancano alcune estensioni. Usa il gestore per installarle, poi riavvia ComfyUI.

#Licenze: ciò che puoi fare

ComfyUI è software libero, ma ogni modello ha la propria licenza e spesso si verifica un malinteso: la licenza del modello non è quella delle immagini che produce. Prima di utilizzare un'immagine per un cliente, un prodotto o una pubblicità, leggi la scheda del modello che l'ha generata.

• Il kit Immagini IA: workflow pronti all'uso e impostazioni per scheda grafica
• Documentazione ufficiale di ComfyUI
• Il repository ComfyUI su GitHub

#FAQ