Workflow ComfyUI: dove trovarli e come charger

#Che cos'è un workflow ComfyUI, e cosa non contiene

In ComfyUI, tutto ciò che vedi sul canvas costituisce il workflow: i nodi (caricamento del modello, prompt, sampler, decodifica VAE, salvataggio), le loro impostazioni e i collegamenti che li uniscono. Quando salvi, ComfyUI serializza questo grafo in JSON. Quando generi un'immagine con il nodo Save Image, per impostazione predefinita inserisce una copia dello stesso grafo nei metadati del file PNG. Ecco perché un'immagine prodotta da ComfyUI può fungere da file di workflow: rilasciarla sul canvas ricrea il grafo che l'ha generata.

Un workflow descrive una ricetta, non i suoi ingredienti. Contiene i nomi dei file dei modelli (checkpoint, LoRA, VAE, ControlNet) e i tipi di nodi usati, ma né i pesi dei modelli né il codice dei custom node. È l'origine di quasi tutti i problemi di caricamento: il grafo si apre, ma la tua installazione non ha tutto ciò che richiede.

Formato interfaccia (workflow)

Il JSON completo, con la posizione dei nodi, i gruppi, le note e i collegamenti. È quello prodotto dal salvataggio normale e quello che si condivide tra utenti.

Formato API (prompt)

Una versione ridotta che conserva solo i nodi e i loro input, senza layout. Serve a controllare ComfyUI tramite script attraverso la sua API HTTP. Il menu di esportazione la propone con il nome Export (API).

Immagine con metadati

Un PNG (o un altro formato, a seconda del nodo di salvataggio) generato da ComfyUI che incorpora le due versioni precedenti nei suoi blocchi di testo.

#Prerequisiti

Ti serve un'installazione di ComfyUI che generi già un'immagine con il workflow predefinito. Se non è così, parti dalla guida all'installazione di ComfyUI: caricare un workflow di terze parti su un'installazione che non funziona mescola due fonti di guasto e rende difficile la diagnosi.

ComfyUI aggiornato

Un workflow recente può usare nodi integrati assenti nelle versioni precedenti. Desktop si aggiorna da solo; per un'installazione manuale, un git pull nella cartella ComfyUI seguito dall'aggiornamento delle dipendenze.

ComfyUI Manager

Indispensabile per installare i custom node richiesti da un workflow. La sua installazione è spiegata nella nostra guida dedicata al Manager.

Sapere dove sono le tue cartelle

models (e le sue sottocartelle checkpoints, loras, vae, controlnet, diffusion_models, text_encoders…), custom_nodes e user/default/workflows, dove ComfyUI salva i workflow registrati.

Spazio su disco

Un workflow di terze parti può richiedere diversi modelli da diversi gigabyte ciascuno. Controlla la dimensione indicata prima di scaricare tutto.

#Dove trovare workflow di ComfyUI affidabili

Non tutte le fonti si equivalgono. Un buon workflow per iniziare usa nodi integrati o estensioni molto diffuse, indica i modelli necessari con i relativi link e risale a meno di un anno fa. Ecco le fonti in ordine di affidabilità decrescente.

1. 01
   I modelli integrati (template)

   L'interfaccia attuale di ComfyUI offre una libreria di workflow pronti all'uso, accessibile dal menu Workflow (voce Browse Templates, oppure pannello Modelli a seconda della versione e della lingua dell'interfaccia). Coprono testo-immagine, immagine-immagine, inpainting, upscale, ControlNet e i modelli di immagine o video supportati ufficialmente. Usano solo nodi integrati e molti indicano dove scaricare i modelli necessari. È il punto di partenza migliore.
2. 02
   La documentazione e gli esempi ufficiali

   La documentazione su docs.comfy.org accompagna i modelli supportati con tutorial e workflow da scaricare. Lo storico sito di esempi del repository ComfyUI (comfyanonymous.github.io/ComfyUI_examples) pubblica immagini PNG che contengono il proprio workflow: basta salvarle e trascinarle in ComfyUI.
3. 03
   Gli esempi forniti dai custom node

   La maggior parte delle estensioni serie include workflow di esempio nel proprio repository GitHub, spesso in una cartella example_workflows o examples. Quando la cartella segue la convenzione example_workflows, le versioni recenti di ComfyUI la mostrano anche nella libreria dei template una volta installata l'estensione. Sono i riferimenti più affidabili per imparare a usare un'estensione specifica.
4. 04
   Le piattaforme della community

   Civitai, OpenArt e altri siti condividono migliaia di workflow, in JSON o incorporati nelle immagini. Ci trovi pipeline molto curate, ma anche grafi carichi di decine di estensioni, versioni abbandonate e copie di copie. Controlla la data, il numero di estensioni richieste e i commenti prima di scaricare.
5. 05
   Le immagini condivise da altri utenti

   Un'immagine generata da ComfyUI contiene il suo workflow… finché non viene ricompressa. È comodo sui forum o sui repository che servono il file originale, molto meno sui social network (vedi più avanti).

#Caricare un workflow: PNG, JSON o scorciatoia da tastiera

ComfyUI accetta un workflow sotto forma di file JSON o di immagine contenente metadati. Tre metodi, che danno lo stesso risultato.

1. 01
   Drag and drop

   Trascina il file .json o l'immagine .png dal tuo file manager sul canvas di ComfyUI. Il grafo si apre in una nuova scheda di workflow (oppure sostituisce il workflow corrente nelle vecchie interfacce). È il metodo più rapido per le immagini.
2. 02
   Menu Workflow, poi Apri

   Nella barra superiore, menu Workflow, voce Open (Apri). Compare una finestra di selezione file che accetta JSON e immagini. Nella vecchia interfaccia, l'equivalente era il pulsante Load del pannello laterale.
3. 03
   Scorciatoia da tastiera

   Ctrl+O (Cmd+O su Mac) apre la stessa finestra di selezione. Le scorciatoie si possono modificare nelle impostazioni di ComfyUI: se questa non risponde, verifica che non sia stata riassegnata.
4. 04
   Verificare prima di avviare

   Prima di fare clic su Run (o Queue Prompt), scorri il grafo: nodi rossi, finestra di avviso su tipi di nodi mancanti, nomi di modelli che non possiedi. Le sezioni seguenti spiegano come gestire ciascuno di questi casi.

I workflow aperti restano accessibili nelle schede in cima al canvas e, una volta salvati, nel pannello laterale Workflows. Un workflow di terzi aperto ma non salvato scompare se chiudi la sua scheda: salvalo (Ctrl+S) appena funziona.

#L'immagine non carica nulla: metadati persi

Trascini un'immagine e non succede nulla, oppure ComfyUI indica che non trova alcun workflow. Nella stragrande maggioranza dei casi, il file non ha mai contenuto un workflow o lo ha perso strada facendo.

Ricompressione da parte di una piattaforma

La maggior parte dei social network e delle app di messaggistica ricomprime le immagini inviate e ne rimuove i metadati, spesso convertendole in JPEG o in WebP. Il workflow scompare, anche se l'immagine sembra identica.

Screenshot

Uno screenshot contiene solo pixel. Nessuna informazione di generazione sopravvive.

Ritocco o conversione

Aprire l'immagine in un editor e poi salvarla di nuovo, o convertirla in JPEG, in genere rimuove i blocchi di testo del PNG.

Immagine di un altro strumento

AUTOMATIC1111, Forge o Fooocus scrivono i loro parametri in un formato diverso. ComfyUI non ricostruisce un grafo completo a partire da questi dati.

Metadati disattivati

Il server che ha prodotto l'immagine potrebbe essere stato avviato con l'opzione --disable-metadata, che impedisce a ComfyUI di scrivere il workflow nei file.

Per sapere se un'immagine contiene davvero un workflow prima di trascinarla, controlla i suoi metadati. ComfyUI scrive due blocchi di testo nei suoi PNG: prompt (formato API) e workflow (formato interfaccia). Con Python e la libreria Pillow, già presente nell'ambiente di ComfyUI:

import json, sys
from PIL import Image

img = Image.open(sys.argv[1])
data = img.info.get("workflow")
if not data:
    print("Aucun workflow dans ce fichier.")
else:
    wf = json.loads(data)
    with open("workflow_extrait.json", "w", encoding="utf-8") as f:
        json.dump(wf, f, ensure_ascii=False, indent=2)
    print(f"Workflow extrait : {len(wf.get('nodes', []))} nœuds")

python lire_workflow.py image.png
# ou, si exiftool est installé :
exiftool -Workflow -b image.png > workflow_extrait.json

Se il file non contiene nulla, nessuno strumento farà ricomparire il workflow. Cerca la pubblicazione originale: sulle piattaforme specializzate l'autore allega spesso il JSON o l'immagine originale come download separato.

#Nodi e modelli mancanti dopo il caricamento

#Nodi rossi: mancano dei custom node

Se il workflow usa estensioni che non hai, ComfyUI apre una finestra che elenca i tipi di nodi mancanti e li mostra in rosso sul canvas. La soluzione passa da ComfyUI Manager: menu Manager, Install Missing Custom Nodes, poi riavvio completo del server e riapertura del workflow. La procedura passo passo dettagliata, i casi in cui il rilevamento fallisce e gli errori IMPORT FAILED sono trattati nella nostra guida a ComfyUI Manager; non li ripetiamo qui.

Prima di installare, guarda quante estensioni richiede l'elenco. Per fare l'inventario di un JSON senza aprirlo, lo strumento jq elenca i tipi di nodi usati, anche nei sottografi delle versioni recenti; i nomi che non ti dicono nulla sono probabilmente custom node da identificare.

jq -r '[.nodes[]?.type, .definitions.subgraphs[]?.nodes[]?.type] | unique | .[]' workflow.json

#Modelli non trovati: l'errore Value not in list

Il grafo si apre senza nodi rossi, avvii la generazione e ComfyUI si ferma con un errore del tipo Value not in list, citando un nome di file in un campo come ckpt_name o lora_name. Il workflow richiede un modello assente dalla tua cartella models, o presente con un altro nome.

1. 01
   Leggere il nome esatto richiesto

   Il messaggio di errore e il nodo di caricamento (Load Checkpoint, Load LoRA, Load VAE, Load Diffusion Model…) indicano il file atteso. Annota anche la sottocartella: un file messo in checkpoints non comparirà in un nodo che legge diffusion_models.
2. 02
   Usare i link forniti

   I template ufficiali e molti workflow recenti includono i link per scaricare i modelli: in quel caso l'interfaccia propone di recuperarli, oppure una nota del workflow fornisce l'indirizzo. Altrimenti cerca il nome del file sulla pagina dell'autore, su Hugging Face o su Civitai, verificando che si tratti proprio del repository ufficiale del modello.
3. 03
   Oppure selezionare un equivalente

   Hai già un modello della stessa famiglia? Fai clic sul campo del nodo di caricamento e scegli il tuo file dall'elenco. Un checkpoint SDXL sostituisce un altro checkpoint SDXL; non sostituisce né un modello SD 1.5 né un modello Flux, che richiedono altri nodi e altre impostazioni.
4. 04
   Aggiornare l'elenco

   Dopo aver copiato un file in models, l'elenco dei nodi non sempre si aggiorna da solo. Usa il comando di aggiornamento dell'interfaccia (tasto R per impostazione predefinita) o ricarica la pagina.

Tieni conto anche della memoria della tua scheda grafica. Un workflow progettato su una scheda da 24 GB può caricare contemporaneamente un modello di diffusione, un text encoder voluminoso e un ControlNet, e saturare una scheda da 8 o 12 GB. Gli autori indicano raramente il loro hardware: in caso di errore di memoria, cerca una versione quantizzata (GGUF o FP8) dei modelli richiesti, oppure rimuovi i passaggi facoltativi come l'upscale.

#Attenzione ai file di origine sconosciuta

Un file di workflow è JSON: aprirlo in ComfyUI non avvia alcun programma. Il rischio viene da ciò che il workflow ti spinge a installare. Ogni custom node è codice Python che viene eseguito con i tuoi permessi fin dall'avvio di ComfyUI, con accesso ai tuoi file e alla rete. Sono già circolate estensioni malevole: nel 2024 un'estensione distribuita con il nome ComfyUI_LLMVISION è stata segnalata per aver sottratto dati ai suoi utenti.

Estensioni sconosciute

Diffida di un workflow che richiede un'estensione introvabile nel catalogo del Manager, con un repository recente, senza cronologia né utenti. Un workflow popolare non ha alcun motivo di dipendere da un repository oscuro.

Installazioni fuori catalogo

Se l'autore chiede di clonare un repository a mano o di lanciare uno script di installazione, leggi cosa fa lo script prima di eseguirlo.

Formati dei modelli

Preferisci i file .safetensors, che contengono solo pesi. I vecchi formati .ckpt, .pt o .bin si basano spesso su pickle, un formato Python in grado di eseguire codice al caricamento.

Isolation

Per testare un workflow sospetto, usa un'installazione separata (una seconda copia portable, un ambiente virtuale distinto o un container), senza accesso ai tuoi documenti personali.

#Salvare, esportare e condividere i tuoi workflow

Una volta riparato un workflow, salvalo per non dover rifare il lavoro. Ctrl+S (Cmd+S su Mac) oppure il menu Workflow e poi Save lo salva nella cartella user/default/workflows della tua installazione, e compare nel pannello laterale Workflows. Dagli un nome esplicito: modello, utilizzo e data.

Save

Salva nella libreria di ComfyUI, lato server. Comodo nell'uso quotidiano, ma ricordati di fare il backup di questa cartella insieme agli altri tuoi dati.

Esportazione

Scarica sul tuo computer un file JSON in formato interfaccia. È il formato da condividere.

Export (API)

Scarica il formato API, utile per controllare ComfyUI tramite script o da un altro programma. Inutile per un altro utente dell'interfaccia.

Immagine generata

Ogni immagine prodotta da Save Image contiene già il workflow. Per condividerla insieme al suo grafo, invia il file PNG originale, come allegato o in un archivio, mai una versione ricompressa.

Per condividere in modo pulito, aggiungi un nodo Note che elenchi i modelli utilizzati con i relativi link, le estensioni richieste e la memoria grafica su cui il workflow è stato messo a punto. Verifica anche che i tuoi prompt e i nomi dei file non rivelino nulla di personale: viaggiano insieme al workflow, anche nei metadati delle immagini. Infine, un workflow pubblicato resta opera del suo autore: se ne condividi una versione modificata, cita e linka la pubblicazione originale invece di ripubblicare il file così com'è.

#Risoluzione rapida dei problemi

Trascinare l'immagine non fa nulla

Il file non contiene alcun workflow: ricompressione, screenshot, conversione o immagine di un altro strumento. Verifica con lo script Python qui sopra.

Finestra dei tipi di nodi mancanti

Mancano dei custom node. Manager, Install Missing Custom Nodes, riavvio completo, poi riapertura del workflow.

Nodi ancora rossi dopo l'installazione

Il server non è stato riavviato, l'estensione non è riuscita a caricarsi (IMPORT FAILED nel terminale) oppure il nodo è stato rinominato. Dettagli nella guida a ComfyUI Manager.

Errore Value not in list

Modello assente o messo nella sottocartella sbagliata di models. Scaricalo o scegli un equivalente della stessa famiglia nel nodo.

Input sfasati o valori assurdi

Workflow progettato per un'altra versione di un nodo. Aggiorna ComfyUI e l'estensione interessata, oppure ricrea il nodo a mano e ricollegalo.

Errore di memoria (out of memory)

Il workflow supera la memoria della tua scheda. Usa una versione quantizzata dei modelli, una risoluzione più bassa o elimina i passaggi facoltativi.

Risultato diverso dall'immagine originale

Seed, versione dei modelli, LoRA o sampler sono diversi. Anche con un workflow identico, due macchine non producono necessariamente la stessa immagine al pixel.

#Per approfondire

Caricare i ComfyUI workflows diventa presto naturale una volta sistemati l'installazione, il Manager e l'organizzazione dei modelli. Queste guide completano questa: installare ComfyUI in modo pulito, gestire i custom node, scegliere il tuo strumento di generazione di immagini in locale e padroneggiare ControlNet, un componente presente in molti workflow condivisi.