Hai installato ComfyUI, hai fatto doppio clic e invece delle immagini è comparso un messaggio rosso, oppure la finestra nera si è chiusa da sola. Capita quasi a tutti la prima volta, e capita anche a noi ogni tanto, dopo un aggiornamento: lavoriamo con ComfyUI ogni giorno su una normalissima RTX 3060 da 12 GB e ne abbiamo visti parecchi, di questi errori.
La buona notizia è che quasi sempre la causa è banale: una libreria di Windows che manca, un driver vecchio, un file nella cartella sbagliata. In questa guida abbiamo raccolto i problemi più comuni di chi installa ComfyUI la prima volta, sia con la versione portable sia con l'app Desktop, con la soluzione spiegata passo passo. Abbiamo controllato tutto sulla documentazione ufficiale e sulle segnalazioni degli ultimi mesi (la guida è aggiornata a novembre 2026, ComfyUI 0.46).
Come usare questa pagina: copia il messaggio di errore che vedi, premi Ctrl+F e cercane una parte qui sotto. Gli errori sono scritti esattamente come li mostra ComfyUI.
In breve: l'errore e dove trovi la soluzione
| Se vedi… | Di solito significa | Vai a |
|---|---|---|
c10.dll, WinError 126, MSVCP140.dll | Mancano le librerie Microsoft Visual C++ | Librerie Microsoft |
Torch not compiled with CUDA enabled | Driver NVIDIA vecchio o pacchetto sbagliato | Driver NVIDIA |
no kernel image is available | Pacchetto non adatto alla tua scheda video | Pacchetto giusto |
| La finestra nera si chiude subito | Errore all'avvio che non fai in tempo a leggere | Finestra che si chiude |
Port 8188 is already in use | ComfyUI è già aperto | Porta occupata |
Nodi rossi, node types were not found | Mancano dei nodi personalizzati | Nodi rossi |
Value not in list: ckpt_name | Manca il modello o è nella cartella sbagliata | Modelli mancanti |
CUDA out of memory | La memoria della scheda video non basta | Memoria video |
| Immagine nera o grigia | VAE sbagliato o problema di precisione | Immagini nere |
mat1 and mat2 shapes cannot be multiplied | Modelli di famiglie diverse mescolati | Modelli incompatibili |
| L'app Desktop si apre e si chiude | Aggiornamento dell'app rimasto a metà | App che si chiude |
Prima di tutto: dove leggere l'errore
Per risolvere un problema serve il messaggio esatto. Dove trovarlo dipende da come hai installato ComfyUI.
Versione portable. L'errore compare nella finestra nera che si apre con run_nvidia_gpu.bat. Se c'è una lunga lista di righe che inizia con Traceback, la riga che conta è quasi sempre l'ultima, oppure la prima con la parola Error.
App Desktop. I messaggi dell'app sono nel menu (le tre linee in alto) → Desktop Settings → Logs → Open logs folder (il file si chiama app.log). Quelli di ComfyUI vero e proprio li trovi nella scheda della tua installazione: i tre puntini → Manage → scheda Terminal.
Errore nell'interfaccia. Se ComfyUI parte ma un nodo diventa rosso, il messaggio compare in un riquadro nel browser e anche nella finestra nera (o nel Terminal dell'app).
Problemi della versione portable
La versione portable è il pacchetto .7z da scaricare da GitHub, estrarre e avviare con run_nvidia_gpu.bat. È la più usata nelle guide, ed è anche quella che dà più problemi la prima volta, perché usa le librerie e i driver che hai già sul PC.
Errore "c10.dll", "WinError 126" o "MSVCP140.dll non trovato": mancano le librerie Microsoft
Messaggi tipici:
OSError: [WinError 126] The specified module could not be found. Error loading "...\torch\lib\c10.dll" or one of its dependencies.DLL load failed, oppure una finestra di Windows che dice che mancaMSVCP140.dlloVCRUNTIME140.dll
Perché succede: PyTorch, il motore che fa girare i modelli, ha bisogno di un pacchetto di librerie Microsoft chiamato Visual C++ Redistributable. Su molti PC c'è già perché l'hanno installato altri programmi o giochi, su un PC nuovo o appena formattato spesso manca.
Come risolvere:
- Scarica il pacchetto ufficiale Microsoft da questo indirizzo: https://aka.ms/vc14/vc_redist.x64.exe. È lo stesso link che ComfyUI scrive nel suo file di avvio.
- Apri il file scaricato e clicca Installa. Se ti dice che è già installato, scegli Ripristina: a volte l'installazione esistente è danneggiata.
- Riavvia il computer.
- Avvia di nuovo
run_nvidia_gpu.bat.
In giro trovi ancora il vecchio link aka.ms/vs/17/release/vc_redist.x64.exe: funziona, ma oggi Microsoft indica quello sopra. Se l'errore resta anche dopo l'installazione, la causa più probabile è il driver della scheda video (vedi il prossimo punto).
"Torch not compiled with CUDA enabled" o "The NVIDIA driver on your system is too old"
Perché succede: Il pacchetto portable standard usa una versione di PyTorch per CUDA 13, che richiede un driver NVIDIA recente (della serie 580 o successiva). Con un driver più vecchio ComfyUI non vede la scheda video. Lo stesso errore compare se hai una scheda AMD o Intel e hai scaricato il pacchetto NVIDIA.
Come risolvere:
- Controlla la versione del driver: premi i tasti Windows + R, scrivi
cmd, premi Invio e nella finestra scrivinvidia-smi. Il numero del driver è nella prima riga in alto (per esempio "Driver Version: 581.xx"). - Se il numero è inferiore a 580, installa il driver più recente dall'app NVIDIA oppure da nvidia.com/drivers. Vanno bene sia i driver Game Ready sia quelli Studio.
- Riavvia il PC e avvia di nuovo
run_nvidia_gpu.bat. - Se hai una scheda AMD o Intel Arc, il driver NVIDIA non c'entra: scarica il pacchetto giusto per la tua scheda (vedi sotto).
NVIDIA non pubblica un numero minimo ufficiale per Windows: il "580" viene dalla serie di driver legata a CUDA 13. Nel dubbio, installa semplicemente l'ultimo driver disponibile.
"no kernel image is available" o "sm_61 is not compatible": il pacchetto non è adatto alla tua scheda
Messaggi tipici: NVIDIA GeForce GTX 1060 with CUDA capability sm_61 is not compatible with the current PyTorch installation e poi CUDA error: no kernel image is available for execution on the device. Con le RTX serie 50 il numero diventa sm_120.
Perché succede: Dalla pagina dei download di ComfyUI si possono scaricare pacchetti diversi, e ognuno funziona solo con certe schede. Il pacchetto standard non supporta più le schede GTX serie 10 e precedenti; il pacchetto per le schede vecchie, al contrario, non supporta le RTX serie 50.
Quale pacchetto scaricare (dalla pagina releases di ComfyUI su GitHub):
| La tua scheda video | File da scaricare |
|---|---|
| NVIDIA RTX 20, 30, 40, 50 e GTX 16 | ComfyUI_windows_portable_nvidia.7z |
| NVIDIA GTX 10 (1060, 1070, 1080…) e precedenti | ComfyUI_windows_portable_nvidia_cu126.7z |
| AMD Radeon RX 6000, 7000, 9000 | ComfyUI_windows_portable_amd.7z (si avvia con run_amd_gpu.bat) |
| Intel Arc | ComfyUI_windows_portable_intel.7z (si avvia con run_intel_gpu.bat) |
Come risolvere:
- Controlla che scheda hai: premi Ctrl + Maiusc + Esc per aprire Gestione attività, vai su Prestazioni e clicca su GPU. Il nome della scheda è in alto a destra.
- Scarica il pacchetto giusto dalla tabella.
- Estrailo in una cartella nuova (vedi i consigli qui sotto) e avvia il file
.batcorrispondente. - Con le RTX serie 50 non riusare un pacchetto portable vecchio, scaricato prima del 2025: non contiene il supporto per queste schede.
L'estrazione del file .7z non funziona o mancano delle cartelle
Sintomi: 7-Zip segnala Data error o Cannot open the file as archive, oppure quando avvii ComfyUI compare '.\python_embeded\python.exe' is not recognized.
Perché succede: Il file pesa circa 2 GB: se il download si è interrotto è incompleto. Oppure Windows ha bloccato il file perché arriva da internet.
Come risolvere:
- Confronta la dimensione del file scaricato con quella indicata su GitHub. Se è diversa, scaricalo di nuovo.
- Installa 7-Zip, gratuito: le versioni vecchie di Esplora file non aprono bene i
.7z. - Se l'estrazione fallisce ancora: tasto destro sul file
.7z→ Proprietà → in basso spunta Annulla blocco (Unblock) → OK. - Estrai con tasto destro → 7-Zip → Estrai qui, in una cartella dal percorso corto.
- Controlla che dentro ci siano le cartelle
ComfyUI,python_embededeupdatee il filerun_nvidia_gpu.bat.
Dove mettere la cartella di ComfyUI
Molti problemi strani (file che spariscono, errori di permessi, nodi che non si installano) nascono dalla posizione della cartella. Il nostro consiglio:
- usa un percorso corto su un disco locale, per esempio
C:\AI\ComfyUI_windows_portableoppureD:\AI\...; - evita il Desktop, i Documenti e i Download se sul PC è attivo OneDrive, perché quelle cartelle vengono sincronizzate sul cloud;
- se compare l'errore
Filename too longinstallando dei nodi, Windows ha un limite di 260 caratteri per i percorsi: spostare la cartella più in alto (per esempio direttamente inC:\AI) di solito basta.
Per chi è pratico, esiste anche un'impostazione di Windows che toglie il limite dei percorsi lunghi (Criteri di gruppo → "Abilita percorsi lunghi Win32"), ma serve accesso da amministratore e per un principiante spostare la cartella è più semplice.
La finestra nera si apre e si chiude subito
Perché succede: C'è un errore all'avvio, ma la finestra si chiude prima che tu riesca a leggerlo. Il file run_nvidia_gpu.bat originale finisce con un comando che tiene la finestra aperta: se si chiude lo stesso, di solito hai copiato il file .bat in un'altra cartella (per esempio sul Desktop) o l'hai modificato.
Come risolvere:
- Apri la cartella di ComfyUI portable.
- Clicca nella barra dell'indirizzo in alto in Esplora file, scrivi
cmde premi Invio: si apre una finestra già nella cartella giusta. - Scrivi
run_nvidia_gpu.bate premi Invio. Ora la finestra resta aperta e puoi leggere l'errore. - Se vuoi avviare ComfyUI dal Desktop, non copiare il file
.bat: crea un collegamento (tasto destro sul file → Mostra altre opzioni → Crea collegamento) e sposta quello. Il file.batfunziona solo dalla sua cartella.
"Port 8188 is already in use"
Il messaggio completo è Port 8188 is already in use on address 127.0.0.1. Please close the other application or use a different port with --port.
Perché succede: ComfyUI è già aperto, per esempio perché hai fatto doppio clic due volte, oppure è aperta anche l'app Desktop.
Come risolvere:
- Chiudi tutte le finestre nere di ComfyUI e l'eventuale app Desktop.
- Se l'errore resta, apri Gestione attività (Ctrl + Maiusc + Esc), cerca i processi
python.exerimasti aperti e chiudili con Termina attività. - Se vuoi usare due ComfyUI insieme, fai una copia del file
.bat, aprila con tasto destro → Modifica e aggiungi--port 8189alla fine della prima riga. Poi aprihttp://127.0.0.1:8189nel browser.
Il browser non si apre o la pagina resta bianca
Come risolvere:
- Aspetta che nella finestra nera compaia la riga
To see the GUI go to: http://127.0.0.1:8188. - Apri Chrome o Edge e scrivi a mano
http://127.0.0.1:8188. - Aggiorna il browser: la documentazione ufficiale indica come minimo Chrome 143, e con le versioni vecchie l'interfaccia può non caricarsi.
- Se usi una VPN o un proxy aziendale, prova a disattivarli.
Il Manager non c'è: non riesco a installare nodi
Perché succede: Da dicembre 2025 il ComfyUI Manager (lo strumento per installare nodi e modelli) è integrato in ComfyUI, ma nella versione portable è spento: va installato e attivato una volta. Molte guide vecchie dicono di scaricarlo con git clone nella cartella custom_nodes: funziona ancora, ma oggi il metodo ufficiale è questo.
Come risolvere:
- Nella cartella principale di ComfyUI portable crea un file di testo e chiamalo
installa_manager.bat(attenzione che l'estensione sia.bate non.txt). - Aprilo con il Blocco note e scrivi due righe: nella prima
.\python_embeded\python.exe -m pip install -r ComfyUI\manager_requirements.txt, nella secondapause. Poi salva. - Fai doppio clic su
installa_manager.bate aspetta che finisca. - Fai una copia di
run_nvidia_gpu.bate chiamala per esempioavvia_con_manager.bat. - Tasto destro sulla copia → Modifica, e cambia la prima riga così:
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --enable-manager - Da ora avvia ComfyUI con
avvia_con_manager.bat. Nell'interfaccia trovi il Manager nell'icona del puzzle o nel menu → Manage Extensions.
Nell'app Desktop il Manager è già attivo, non devi fare niente.
L'antivirus cancella dei file
Se dopo l'estrazione mancano dei file o Windows mostra "Minaccia messa in quarantena", apri Sicurezza di Windows → Protezione da virus e minacce → Cronologia protezione e guarda quale file è stato bloccato. Ripristinalo solo se fa parte del pacchetto ufficiale scaricato da github.com/Comfy-Org. Non disattivare l'antivirus per tutta la cartella: i nodi personalizzati sono codice di terze parti, e in passato qualcuno ha contenuto davvero del software malevolo.
Problemi dell'app Desktop
Attenzione alle guide vecchie: nel 2026 l'app ufficiale è stata rifatta da zero e oggi si chiama Comfy Desktop (versione 1.x). Ha una schermata iniziale con le tue installazioni, chiamate "istanze", e salvataggi automatici. La pagina di manutenzione, il pulsante "Reinstall" e i controlli su Git e Visual C++ che trovi in molti tutorial appartengono alla vecchia app, che ora si chiama Legacy Desktop.
L'app si scarica da comfy.org/download. Su Windows funziona con schede NVIDIA, e ci sono versioni anche per AMD (RX 6000 e successive), Intel Arc e solo processore. Sul Mac richiede un chip Apple Silicon (M1 o successivi) con macOS 13 o più recente: i Mac con processore Intel non sono supportati.
L'app si apre per un secondo e si chiude (dopo un aggiornamento)
Perché succede: L'aggiornamento automatico dell'app si è fermato a metà. È un problema noto delle versioni fino alla 1.0.46.
Come risolvere:
- Scarica l'installer più recente da comfy.org/download.
- Avvialo sopra l'app esistente, senza disinstallarla prima: installazioni, modelli e impostazioni restano al loro posto.
- Se non basta, questa è una soluzione segnalata da diversi utenti ma non ufficiale: chiudi l'app, apri con il Blocco note il file
%APPDATA%\Comfy Desktop\settings.json(incolla il percorso nella barra di Esplora file) e cambia"installUpdatesOnStartup": trueinfalse. Salva e riapri l'app.
L'app non si apre affatto
- Su Windows: tasto destro sull'icona → Esegui come amministratore, solo la prima volta.
- Sul Mac: Impostazioni di Sistema → Privacy e sicurezza → in basso clicca Apri comunque.
- Assicurati di avere l'ultima versione dell'app.
"This file was blocked by application control policy" (Windows 11)
Messaggi tipici: ImportError: DLL load failed while importing ...: This file was blocked by application control policy.
Perché succede: Su alcuni PC con Windows 11 è attivo Smart App Control, una protezione che blocca i file che non hanno una firma digitale, e alcune librerie di Python non ce l'hanno.
Cosa sapere: Al momento (novembre 2026) non esiste una soluzione ufficiale: il problema è segnalato agli sviluppatori. L'unico modo per farlo funzionare è disattivare Smart App Control in Sicurezza di Windows → Controllo delle app e del browser → Impostazioni di Smart App Control. È una protezione di sicurezza, e una volta disattivata Windows permette di riattivarla solo reinstallando il sistema: valuta tu se ne vale la pena, oppure usa la versione portable.
Il primo download si blocca o compare "ERR_CONNECTION_RESET"
Perché succede: Alla prima installazione l'app scarica diversi GB (l'ambiente Python e PyTorch). Se la connessione si interrompe, il download fallisce.
Come risolvere:
- Usa una connessione stabile, meglio via cavo; disattiva VPN e hotspot del telefono.
- Riprova a creare l'installazione: l'app riusa la parte già scaricata.
- Controlla nel menu (le tre linee in alto) → Desktop Settings → Advanced che PyPI Mirror URL sia vuoto e Use Chinese Mirrors spento (servono solo dalla Cina).
Schermata "Operation failed"
- Premi Reboot (o Restart ComfyUI) per riprovare.
- Se fallisce ancora, apri i log dal menu → Desktop Settings → Logs e la scheda Terminal in Manage per leggere l'errore vero, poi cercalo in questa pagina.
- Se l'installazione resta rotta: i tre puntini sulla sua scheda → Uninstall, poi crea una nuova installazione con New Instance. I modelli sono in una cartella condivisa e non vengono cancellati.
"Torch not compiled with CUDA enabled" o "access violation" all'avvio dell'app
- Aggiorna l'app all'ultima versione.
- Aggiorna il driver NVIDIA: l'app stessa mostra un avviso se il driver è più vecchio della serie 580.
- Se l'errore resta: i tre puntini → Manage → scheda Update → nella sezione PyTorch scegli un'altra versione e premi Change PyTorch. Con Copy & Change PyTorch fai la prova su una copia, senza toccare l'installazione originale.
Ho una scheda GTX serie 10
Con le GTX 1060, 1070, 1080 e simili compare l'avviso "needs compute capability 7.5" oppure, generando, no kernel image is available. In Manage → Update → PyTorch scegli la versione cu126 (quella per le schede più vecchie) e premi Change PyTorch.
Non riesco a scegliere la cartella di installazione
Se il pulsante Continue resta grigio, l'app sta rifiutando la cartella scelta: non accetta le cartelle di OneDrive né quelle già usate da un'altra installazione. Scegli una cartella normale su un disco locale, per esempio D:\ComfyUI-Installs. La cartella predefinita si cambia nel menu (le tre linee in alto) → Desktop Settings → Advanced → Default Install Location.
Dove sono i miei file nell'app Desktop
| Cosa | Windows | Mac |
|---|---|---|
| Installazioni | %LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Installs | ~/ComfyUI-Installs |
| Modelli, input e output condivisi | %LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Shared | ~/ComfyUI-Shared |
| Impostazioni e log | %APPDATA%\Comfy Desktop | ~/Library/Application Support/Comfy Desktop |
Per aprire queste cartelle su Windows, incolla il percorso nella barra dell'indirizzo di Esplora file. Se avevi già una versione portable, puoi aggiungerla all'app dal menu (le tre linee in alto) → Add Existing Instance, senza copiare niente.
Il primo workflow: nodi rossi e modelli mancanti
ComfyUI parte, carichi un workflow scaricato da internet e qualcosa diventa rosso. Sono i problemi più frequenti in assoluto, e i più facili da risolvere.
"When loading the graph, the following node types were not found"
Perché succede: Il workflow usa dei nodi personalizzati (estensioni create dalla community) che sul tuo ComfyUI non sono installati.
Come risolvere:
- Assicurati che il Manager sia attivo (nella portable va attivato, vedi sopra).
- Quando carichi il workflow, ComfyUI propone di installare i nodi mancanti: scegli Install All, oppure Open Manager per vederli uno per uno.
- Al termine chiudi e riavvia ComfyUI completamente (non basta ricaricare la pagina), poi ricarica il workflow.
- Se dei nodi restano rossi, guarda nella finestra nera se compare
IMPORT FAILED(vedi il punto successivo).
"IMPORT FAILED": il nodo è installato ma non si carica
Perché succede: Al nodo manca una libreria Python oppure è in conflitto con un'altra estensione o con la tua versione di ComfyUI.
Come risolvere:
- Nella finestra nera, risali sopra la riga
IMPORT FAILED: il primo errore che trovi (di solitoModuleNotFoundError: No module named ...) è la causa vera. - Nel Manager aggiorna quel nodo. Se compare il pulsante Try Fix, usalo: reinstalla le librerie del nodo.
- Per capire se il problema è un nodo personalizzato, avvia ComfyUI senza estensioni: nella portable fai una copia del
.bate aggiungi--disable-all-custom-nodesalla prima riga. Se così funziona, il colpevole è una delle estensioni. - Se un nodo continua a dare problemi, disattivalo dal Manager e cerca un'alternativa.
"This action is not allowed with this security level configuration"
Perché succede: Il Manager ha un livello di sicurezza che blocca alcune installazioni considerate rischiose, per esempio da un indirizzo GitHub o da fuori dal catalogo ufficiale.
Come risolvere:
- Nella portable apri il file
ComfyUI\user\__manager\config.inicon il Blocco note (nelle versioni più vecchie è inComfyUI\user\default\ComfyUI-Manager\config.ini; il percorso esatto è scritto nella finestra nera all'avvio). - Cambia la riga
security_level = normalinsecurity_level = weak, salva e riavvia ComfyUI. - Installa quello che ti serve, poi **rimetti
normal**: il livelloweakpermette tutto, anche installazioni potenzialmente pericolose. - Nell'app Desktop lo stesso si fa da Manage → Startup Args → Manager Security Level.
"Value not in list: ckpt_name": manca il modello
Messaggio tipico: Prompt outputs failed validation: CheckpointLoaderSimple: Value not in list: ckpt_name: 'nome_modello.safetensors' not in []
Perché succede: ComfyUI non contiene modelli: vanno scaricati a parte. Oppure il modello c'è, ma è nella cartella sbagliata, o il workflow cerca un file con un nome diverso dal tuo.
In quale cartella va ogni modello (dentro ComfyUI\models):
| Tipo di file | Cartella |
|---|---|
| Checkpoint completi (SD 1.5, SDXL…) | checkpoints |
| Modelli di diffusione separati (Flux, Wan, Qwen-Image…) e file GGUF | diffusion_models (va bene anche la vecchia unet) |
| Codificatori del testo (CLIP, T5, Qwen…) | text_encoders (va bene anche la vecchia clip) |
| VAE | vae |
| LoRA | loras |
| Upscaler | upscale_models |
| ControlNet | controlnet |
Come risolvere:
- Metti il file nella cartella giusta della tabella.
- Nell'interfaccia premi il tasto R per aggiornare l'elenco dei modelli, oppure riavvia.
- Clicca sul nodo rosso e scegli il file dal menu a tendina: i workflow scaricati portano il nome del file dell'autore, che può essere diverso dal tuo.
- Nell'app Desktop i modelli vanno nella cartella condivisa (
ComfyUI-Shared\models), non nella cartella del programma.
Il pulsante "Download" dei modelli mancanti non fa niente
Quando apri un template dal menu Template di ComfyUI, compare l'elenco dei modelli mancanti con il pulsante per scaricarli. A volte non funziona: è un problema noto, segnalato agli sviluppatori e non ancora risolto.
Come risolvere:
- Nell'app Desktop riprova dal riquadro Downloads in alto.
- Altrimenti scarica il file a mano dalla pagina di Hugging Face e mettilo nella cartella giusta della tabella sopra.
- Su Hugging Face usa il pulsante di download della pagina del file: l'indirizzo giusto contiene
/resolve/main/. Se l'indirizzo contiene/blob/main/, stai scaricando la pagina web e non il modello.
Un workflow scaricato da internet non si apre
Il workflow è salvato dentro le immagini PNG originali e nei file .json. Se trascini un'immagine e compare solo un nodo "Load Image", quell'immagine non contiene il workflow: molti siti e social convertono le immagini in JPG o WebP e cancellano i dati. Cerca il file .json o il PNG originale, e aprilo con il menu File → Open invece di trascinarlo. Dopo l'apertura possono mancare nodi e modelli: vedi i punti sopra.
Memoria e velocità
"CUDA out of memory" o "Allocation on device"
Perché succede: Il modello, insieme alla risoluzione, al numero di immagini o alla durata del video, richiede più memoria di quella della tua scheda video.
Come risolvere, in quest'ordine:
- Abbassa la risoluzione, il numero di immagini per volta (batch size) o la durata del video.
- Chiudi gli altri programmi che usano la scheda video: browser con tante schede, giochi, editor video.
- Usa una versione più leggera del modello: fp8 oppure GGUF (file compressi che occupano meno memoria, si caricano con l'estensione ComfyUI-GGUF).
- Lascia un po' di memoria libera a Windows aggiungendo
--reserve-vram 2alla prima riga del file.bat(nell'app Desktop: Manage → Startup Args).
Da marzo 2026 ComfyUI gestisce la memoria video in automatico (Dynamic VRAM) sulle schede NVIDIA. Per questo il vecchio consiglio "aggiungi --lowvram" oggi da solo non fa più niente: funziona solo insieme a --disable-dynamic-vram. Prova prima i punti sopra.
Su una scheda da 12 GB come la nostra RTX 3060, con i modelli in fp8 o GGUF si fanno tranquillamente immagini con Flux e video brevi: se vuoi capire quanta memoria serve per cosa, trovi i dettagli nella nostra guida alle schede video per l'AI. Per i video, quanta memoria serve a ogni modello lo trovi nella guida ai modelli AI per video in ComfyUI.
"The paging file is too small" (WinError 1455)
Perché succede: Qui la scheda video non c'entra, perché è finita la RAM del computer. Windows usa una parte del disco come memoria aggiuntiva (il file di paging), e quella impostata è troppo piccola per caricare un modello grande.
Come risolvere:
- Premi Windows + R, scrivi
sysdm.cple premi Invio. - Scheda Avanzate → nella sezione Prestazioni clicca Impostazioni → scheda Avanzate → Memoria virtuale → Cambia.
- Togli la spunta da "Gestisci automaticamente", seleziona il disco più veloce (meglio un SSD con spazio libero), scegli Dimensioni personalizzate e imposta per esempio 32768 MB sia come iniziale sia come massima.
- Clicca Imposta, OK e riavvia il PC.
Ingrandire il file di paging non risolve invece un errore CUDA out of memory, che riguarda la scheda video.
Se l'errore torna spesso, il computer ha poca RAM per i modelli che usi. Noi lavoriamo con 32 GB, e nella pagina Configurazioni PC 2026 trovi i computer che consigliamo per l'AI.
ComfyUI è lentissimo: sta usando il processore
Se un'immagine richiede molti minuti e in Gestione attività la scheda video resta ferma, ComfyUI sta lavorando con il processore invece che con la scheda. Nella finestra nera all'avvio compare Device: cpu.
- Avvia ComfyUI con
run_nvidia_gpu.bat, non conrun_cpu.bat(dalla versione 0.45 è stato spostato nella cartellaadvanced). - Controlla se PyTorch vede la scheda: apri
cmdnella cartella di ComfyUI portable e scrivi.\python_embeded\python.exe -c "import torch; print(torch.cuda.is_available())". Se rispondeFalse, aggiorna il driver (vedi sopra) o scarica di nuovo il pacchetto giusto.
Sage Attention, Triton, xformers: non ti servono
Molti video promettono generazioni più veloci con Sage Attention, Triton o xformers. Sono ottimizzazioni facoltative, delicate da installare su Windows, e sono tra le cause più frequenti di un ComfyUI che smette di partire (per esempio con No module named 'sageattention'). Se hai appena installato ComfyUI, lasciale stare. Se le hai aggiunte e qualcosa non va, togli --use-sage-attention dal file .bat e ComfyUI torna a funzionare con il metodo standard.
Immagini sbagliate e file rovinati
Immagini nere o grigie
Perché succede: Un'immagine tutta nera, senza errori, di solito nasce da un problema di precisione dei calcoli nel VAE (la parte che trasforma il risultato in un'immagine vera). Un'immagine grigia o marrone indica spesso un VAE che non è quello giusto per il modello.
Come risolvere:
- Usa il VAE che va con il modello: per SDXL il file consigliato è
sdxl_vae_fp16_fix.safetensors, per Fluxae.safetensors. - Prova ad aggiungere
--fp32-vaealla prima riga del file.bat: fa lavorare il VAE con più precisione. Attenzione, in alcune guide trovi--force-fp32-vae, che non esiste. - Se ancora non va, parti da un template ufficiale di ComfyUI per quel modello: contiene la combinazione giusta di file.
"mat1 and mat2 shapes cannot be multiplied"
Errori simili: expected input ... to have 4 channels, but got 16 channels instead, The size of tensor a must match the size of tensor b.
Perché succede: Stai usando insieme file di famiglie diverse: per esempio un VAE di SDXL con un modello Flux, una LoRA di SD 1.5 con un modello SDXL, o il codificatore del testo sbagliato.
Come risolvere:
- Usa modello, VAE, codificatore del testo, LoRA e ControlNet della stessa famiglia (SD 1.5, SDXL, Flux, Qwen-Image…).
- Se l'errore parla di 4 e 16 canali: SD 1.5 e SDXL lavorano con 4 canali, Flux e SD3 con 16. Hai mescolato le due famiglie.
- Il modo più sicuro: apri il template ufficiale del modello dal menu Template di ComfyUI e sostituisci solo quello che ti serve.
Per sapere quali file servono a ogni modello, trovi l'elenco completo nella nostra guida ai modelli AI per immagini in ComfyUI.
"Error while deserializing header" (HeaderTooLarge)
Perché succede: Il file del modello è rovinato o incompleto. A volte si tratta addirittura di una pagina web salvata con il nome .safetensors. Succede quando si scarica da Hugging Face l'indirizzo della pagina invece di quello del file, o da una pagina che richiede l'accesso.
Come risolvere:
- Guarda la dimensione del file: se pesa pochi KB invece di diversi GB, è una pagina web.
- Scaricalo di nuovo con il pulsante di download (indirizzo con
/resolve/main/). Per i modelli che richiedono di accettare una licenza, accedi a Hugging Face e accettala prima. - Preferisci sempre i file
.safetensorsai.ckpte.pt, che possono contenere codice eseguibile.
Dopo un aggiornamento qualcosa non va più
Quale file usare per aggiornare la portable
Nella cartella update della portable ci sono tre file:
| File | Cosa fa | Quando usarlo |
|---|---|---|
update_comfyui_stable.bat | Aggiorna all'ultima versione stabile | Il nostro consiglio per i principianti |
update_comfyui.bat | Aggiorna all'ultima versione in sviluppo | Se ti serve una novità appena uscita |
update_comfyui_and_python_dependencies.bat | Aggiorna anche PyTorch e tutte le librerie | Solo se compaiono errori di librerie: è un download grande |
Prima di un aggiornamento importante fai una copia della cartella di ComfyUI (o almeno di ComfyUI\custom_nodes e ComfyUI\user): se qualcosa si rompe, torni indietro in un attimo.
Errori con NumPy dopo un aggiornamento
Messaggi tipici: A module that was compiled using NumPy 1.x cannot be run in NumPy 2.x oppure numpy.core.multiarray failed to import.
Perché succede: Un aggiornamento o un nuovo nodo ha cambiato la versione di NumPy (una libreria di calcolo) e un'estensione più vecchia non la supporta.
Come risolvere:
- Aggiorna dal Manager il nodo che dà errore: spesso l'autore ha già sistemato.
- Se non basta, disattiva quel nodo o torna alla copia di prima dell'aggiornamento.
- Evita di cambiare a mano la versione di NumPy se non te lo chiede l'autore del nodo: rischi di rompere altre estensioni.
Interfaccia rotta o vecchia dopo l'aggiornamento
Sintomi: pagina bianca o grigia, menu fuori posto, o nella finestra nera l'avviso Installed comfyui-frontend-package version ... is lower than the recommended version.
- Ricarica la pagina svuotando la cache del browser: Ctrl + F5.
- Nella portable avvia di nuovo
update\update_comfyui.bat: aggiorna anche l'interfaccia. - Se il problema resta, in Settings → Extensions disattiva le estensioni di terze parti e riattivale una alla volta per trovare quella che dà fastidio.
- Se la tua portable ha molti mesi o anni, l'aggiornamento non basta: scarica un pacchetto nuovo e sposta dentro le cartelle
ComfyUI\models,ComfyUI\output,ComfyUI\usere i nodi che ti servono.
Tornare indietro alla versione di prima
- App Desktop: Manage → Snapshots. L'app salva da sola una copia prima e dopo ogni aggiornamento (i modelli non sono inclusi): ripristina quella precedente. La prossima volta usa Copy & Update per provare l'aggiornamento su una copia.
- Portable: se hai fatto la copia della cartella, rimettila al suo posto. Altrimenti, il Manager salva delle "istantanee" dei nodi installati che si possono ripristinare.
Se niente funziona: ricominciare senza perdere i modelli
A volte la strada più veloce è un'installazione pulita, e i modelli (che sono la parte pesante) non vanno riscaricati.
- Portable: scarica un pacchetto nuovo, estrailo in una cartella diversa e sposta nella nuova cartella
ComfyUI\models,ComfyUI\outputeComfyUI\user(lì ci sono workflow e impostazioni). I nodi personalizzati reinstallali dal Manager invece di copiarli. - App Desktop: crea una nuova installazione con New Instance: i modelli sono nella cartella condivisa e la nuova installazione li vede subito.
- Modelli in una cartella sola per più installazioni: nella portable copia il file
extra_model_paths.yaml.example, rinominaloextra_model_paths.yamle scrivi dentro il percorso della tua cartella dei modelli. Nell'app Desktop si fa dal menu (le tre linee in alto) → Desktop Settings → Storage → Add Shared Directory.
Se stai ancora decidendo come installare ComfyUI, nella nostra guida all'installazione di ComfyUI su Windows trovi i due metodi spiegati da zero, e nella pagina ComfyUI: tutti i nostri tutorial tutto il resto.
Domande frequenti
Meglio la versione portable o l'app Desktop per evitare problemi?
Per chi inizia, oggi l'app Desktop dà meno problemi: installa da sola PyTorch, ha il Manager già attivo e salva una copia prima di ogni aggiornamento. Anche il sito ufficiale di ComfyUI consiglia l'app agli utenti normali. La portable resta utile per chi vuole tutto in una cartella, magari su un disco esterno, e per le schede AMD e Intel.
Perché ComfyUI dice che manca un modello che ho già scaricato?
Quasi sempre il file è nella cartella sbagliata o ha un nome diverso da quello scritto nel workflow. Controlla la tabella delle cartelle in questa guida, premi R nell'interfaccia per aggiornare l'elenco e scegli il file dal menu a tendina del nodo.
ComfyUI funziona senza una scheda NVIDIA?
Sì: esistono pacchetti per AMD (RX 6000 e successive) e Intel Arc, e sul Mac funziona con i chip Apple Silicon. Senza una scheda video dedicata ComfyUI parte lo stesso, ma usando solo il processore è molto lento, soprattutto con i modelli recenti. Se il tuo computer non basta, nel confronto immagini con l'AI: meglio in locale o online? trovi anche le alternative online.
Devo installare Python o Git per usare ComfyUI?
No. Sia la portable sia l'app Desktop contengono già il loro Python. Git non serve per l'uso normale: può servire solo per installare alcuni nodi direttamente da un indirizzo GitHub.










