Installazione di ComfyUI e prima generazione di un'immagine

Comfy Desktop è l’applicazione desktop ufficiale di ComfyUI e installa sia ComfyUI sia l’ambiente di esecuzione necessario, senza richiedere la configurazione separata di Python, CUDA o pip. Puoi anche mantenere più installazioni sullo stesso computer, indipendenti tra loro, per provare versioni o configurazioni diverse.

Preparazione prima dell’installazione

Verifica innanzitutto che il computer soddisfi i seguenti requisiti:

• Windows 10 o versione successiva, con supporto x64 o ARM64. È consigliata una scheda grafica dedicata NVIDIA o AMD, ma l’installazione è possibile anche senza una GPU dedicata.
• macOS 13 (Ventura) o versione successiva, esclusivamente su chip Apple (M1 o successivo).
• Linux. I pacchetti di installazione sono disponibili nei formati .deb e AppImage; sono consigliati Ubuntu 22.04 o versione successiva e un’architettura x64.

Ogni installazione di ComfyUI richiede circa 4,85 GB di spazio su disco. Sono necessari almeno 8 GB di memoria, mentre 16 GB sono più adatti per l’uso. I modelli di immagini scaricati successivamente occuperanno ulteriore spazio su disco.

macOS

Apri il dmg

• Trascinalo in Applicazioni
• La prima volta vai in Privacy e sicurezza
• Fai clic su Apri comunque

Windows

Esegui l'exe

• Windows 10 o successivo
• x64 o ARM64
• Crea l'installazione dalla schermata di benvenuto

Linux

deb o AppImage

• Consigliato Ubuntu 22.04+
• x64
• In caso di mancato avvio, consulta le istruzioni sulla sandbox

Installazione e primo avvio

Apri la pagina di download di Comfy Desktop per ottenere il pacchetto di installazione. La pagina rileverà automaticamente il sistema in uso.

macOS

1. Apri il file .dmg scaricato.
2. Trascina Comfy Desktop nella cartella Applicazioni.
3. Apri Comfy Desktop da Launchpad o tramite la ricerca Spotlight.

Al primo avvio, macOS potrebbe mostrare un avviso di sicurezza. Apri quindi Privacy & Security (Privacy e sicurezza) nelle Impostazioni di Sistema e fai clic su Open Anyway (Apri comunque); questo pulsante consente al sistema di avviare l’applicazione appena bloccata.

Windows

Esegui il file .exe scaricato, ossia il pacchetto di installazione NSIS, e segui le istruzioni visualizzate per completare l’installazione. Apri quindi Comfy Desktop dal menu Start o dal collegamento sul desktop.

Al primo avvio verrà mostrata la schermata di benvenuto, dalla quale potrai creare la prima installazione di ComfyUI.

Linux

Linux utilizza un collegamento di download generico. Se usi Debian o Ubuntu, apri la directory dei download in cui si trova il pacchetto di installazione ed esegui:

sudo apt install ./*.deb

Se usi AppImage, esegui:

chmod +x ./*.AppImage
./*.AppImage

Se l’applicazione non si avvia, è possibile che la distribuzione Linux blocchi la sandbox di Electron. Ubuntu 24.04 e versioni successive limitano tramite AppArmor gli spazi dei nomi per gli utenti senza privilegi. Aggiungi --no-sandbox e riprova soltanto dopo aver verificato che l’errore di avvio dipenda dalla sandbox. Questo parametro disattiva la sandbox di Electron per ogni processo e non è consigliato in altre circostanze.

Dopo aver aperto Comfy Desktop, la pagina Chooser mostrerà le istanze già installate. Fai clic su New Instance per creare una nuova installazione indipendente di ComfyUI, quindi fai clic sulla scheda dell’istanza corrispondente per avviarla.

Per impostazione predefinita, la versione desktop segue il canale stabile. Se vuoi ricevere ogni nuovo commit pubblicato su GitHub, puoi usare la versione portatile, eseguire un’installazione git manuale oppure cambiare il canale di aggiornamento dell’istanza in Latest on GitHub.

Ottenere i parametri di connessione da OmniProxy

Non sono disponibili un indirizzo generico, una chiave o un ID modello da inserire. L’installazione di Comfy Desktop e il completamento del flusso di base per la generazione da testo a immagine non richiedono OmniProxy.

Non inserire il Base URL di altri strumenti in nodi di provenienza non chiara. Attendi istruzioni esplicite per un’integrazione generica prima di procedere con una configurazione separata.

Inserire la configurazione dello strumento

Qui non è presente un modulo di configurazione per OmniProxy. Per generare la prima immagine devi prima preparare un workflow e un modello di immagini.

Un workflow può essere considerato come una sequenza di passaggi per generare un’immagine, mentre i nodi sono i moduli operativi che si occupano, per esempio, di caricare il modello, ricevere il testo o salvare l’immagine. Dopo l’avvio, ComfyUI carica normalmente in modo automatico il workflow predefinito per la generazione da testo a immagine.

Per aprire un altro workflow, seleziona Workflows → Open dal menu; questa opzione consente di caricare un’immagine contenente informazioni sul workflow oppure un file di workflow JSON.

La maggior parte delle installazioni non include un modello di base per impostazione predefinita. Dopo aver caricato il workflow, se sul computer non è presente v1-5-pruned-emaonly-fp16.safetensors, l’interfaccia segnalerà che manca il modello. Aprendo l’avviso potrai vedere il modello mancante e il relativo collegamento per il download.

Per controllare la directory dei modelli usata dall’installazione corrente, fai clic sul menu a capsula nella parte superiore e apri Storage; questa sezione consente di verificare dove vengono effettivamente salvati i modelli e gli altri file. Il menu a capsula superiore è disponibile solo nell’applicazione desktop. Facendo clic sull’icona della cartella accanto alla directory puoi aprirla direttamente nel file manager del sistema.

Esistono due modi per scaricare il modello:

• Fai clic su Download nell’interfaccia; questo pulsante avvia il download del modello mancante. La versione desktop salva il modello in ComfyUI/models/checkpoints nell’installazione corrente. Puoi controllare l’avanzamento del download nel pannello dei modelli della barra laterale. Il download automatico viene normalmente effettuato da Hugging Face, quindi la rete deve poter accedere a Hugging Face.
• Se l’avanzamento del download rimane fermo a lungo, apri i dettagli del modello mancante, copia il collegamento per il download, scarica manualmente il file e salvalo nella stessa directory checkpoints. Aggiorna quindi l’interfaccia o riavvia ComfyUI.

Dopo aver posizionato il modello nella directory corretta, premi R sulla tastiera per far rileggere all’interfaccia l’elenco dei modelli nei nodi.

Applicazione

Comfy Desktop

• Si occupa di installare l'ambiente
• Usa la schermata di benvenuto o crea una nuova istanza
• Fai clic sulla scheda per avviare

Workflow

Da testo a immagine

• Di solito viene caricato automaticamente
• Puoi anche aprirlo dal menu
• Se manca il modello, viene mostrato un avviso

Modello

checkpoints

• Scaricalo dal link nell'avviso
• La versione desktop può salvarlo automaticamente
• Premi R per aggiornare l'elenco

Verificare un’attività reale

Dopo aver preparato il modello, prova a generare la prima immagine seguendo questi passaggi:

1. Nel nodo Load Checkpoint, seleziona v1-5-pruned-emaonly-fp16.safetensors. Questo nodo carica il modello da usare per la generazione corrente.
2. Fai clic su Run oppure premi Ctrl + Enter. Run avvia l’esecuzione dell’attività di generazione corrente.
3. Il risultato generato verrà mostrato nel nodo Save Image. Questo nodo consente di visualizzare in anteprima e salvare l’immagine finale; puoi fare clic con il pulsante destro del mouse sull’immagine per salvarla sul computer.

Se in Load Checkpoint non è disponibile alcun modello oppure il menu a discesa mostra null, verifica prima la directory del modello, quindi aggiorna o riavvia ComfyUI.

Alla data 2026-10-09, è stato verificato su macOS che Comfy Desktop 1.1.6, ottenuto dal dmg ufficiale, può essere avviato. Poiché è ancora necessario creare un’installazione nell’applicazione e scaricare il modello checkpoint, il flusso della prima generazione non è stato completato. Pertanto, non si dichiara che un’immagine sia stata generata correttamente e OmniProxy non è stato integrato in ComfyUI.

Modello

Il nome è nel menu a discesa

• Non è null
• Seleziona il checkpoint
• Aggiorna con R

Generazione

Fai clic su Run

• Oppure premi Ctrl+Enter
• Attendi il completamento dei nodi
• L'immagine è in Save Image

Limiti

Per ora non collegare il gateway

• Non esiste un pannello di configurazione generale
• Non installare nodi di provenienza sconosciuta
• È sufficiente generare un'immagine

Errori comuni

• macOS non apre l’applicazione: vai su Impostazioni di Sistema → Privacy e sicurezza e fai clic su Apri comunque. Il pacchetto di installazione supporta soltanto chip Apple e macOS 13 o versioni successive.
• L’applicazione si chiude subito su Linux: verifica innanzitutto di utilizzare il pacchetto .deb o AppImage. Aggiungi --no-sandbox soltanto dopo aver confermato che l’avvio non riesce a causa della sandbox.
• Viene segnalato un modello mancante: scarica il modello checkpoint tramite il collegamento nell’avviso, salvalo nella directory models/checkpoints dell’installazione corrente e premi R per aggiornare.
• Il menu a discesa dei modelli mostra null: controlla la directory del modello tramite Storage, verifica che il file sia stato collocato correttamente, quindi aggiorna o riavvia.
• Vuoi inserire qui i dati di OmniProxy: al momento non è disponibile un campo di integrazione generico. Non installare nodi aggiuntivi che non siano stati indicati esplicitamente come metodo di integrazione generico.

Riferimenti ufficiali

Per una panoramica dell’installazione, consulta Comfy Desktop. Le procedure di installazione per le singole piattaforme sono disponibili nelle pagine macOS, Windows e Linux. Per l’uso dell’interfaccia desktop, consulta Using Comfy Desktop. Per i passaggi della prima generazione, consulta Getting Started with AI Image Generation.

Sostituisci ogni segnaposto con valori dalla tua configurazione OmniProxy personale. Non pubblicare mai una chiave reale.

Un risultato salvato o HTTP 200 da soli non provano la piena compatibilità con l'Agente. Controlla l'origine e il modello nel registro delle chiamate di OmniProxy.

Fonti ufficiali · ComfyUI ↗