Workflows do ComfyUI: onde encontrá-los e como charger

#O que é um workflow do ComfyUI, e o que ele não contém

No ComfyUI, tudo o que você vê no canvas forma o workflow: os nós (carregamento do modelo, prompt, sampler, decodificação VAE, salvamento), suas configurações e as conexões entre eles. Quando você salva, o ComfyUI serializa esse grafo em JSON. Quando você gera uma imagem com o nó Save Image, ele insere por padrão uma cópia desse mesmo grafo nos metadados do arquivo PNG. É por isso que uma imagem gerada pelo ComfyUI pode servir como arquivo de workflow: soltá-la no canvas recria o grafo que a gerou.

Um workflow descreve uma receita, não os ingredientes. Ele contém os nomes dos arquivos de modelos (checkpoint, LoRA, VAE, ControlNet) e os tipos de nós usados, mas nem os pesos dos modelos nem o código dos custom nodes. Essa é a origem de quase todos os problemas de carregamento: o grafo abre, mas sua instalação não tem tudo o que ele exige.

Formato da interface (workflow)

O JSON completo, com a posição dos nós, os grupos, as notas e as conexões. É o que o salvamento normal gera e o que se compartilha entre usuários.

Formato API (prompt)

Uma versão reduzida que mantém apenas os nós e suas entradas, sem layout. Ela serve para controlar o ComfyUI por script por meio da sua API HTTP. O menu de exportação a oferece com o nome Export (API).

Imagem com metadados

Um PNG (ou outro formato, dependendo do nó de salvamento) gerado pelo ComfyUI que incorpora as duas versões anteriores em seus blocos de texto.

#Pré-requisitos

Você precisa de uma instalação do ComfyUI que já gere uma imagem com o workflow padrão. Se esse não for o caso, comece pelo guia de instalação do ComfyUI: carregar um workflow de terceiros em uma instalação que não funciona mistura duas fontes de falha e dificulta o diagnóstico.

ComfyUI atualizado

Um workflow recente pode usar nós nativos que não existem nas versões antigas. O Desktop se atualiza sozinho; em uma instalação manual, faça um git pull na pasta ComfyUI e depois atualize as dependências.

ComfyUI Manager

Indispensável para instalar os custom nodes que um workflow exige. A instalação está detalhada no nosso guia dedicado ao Manager.

Saber onde ficam suas pastas

models (e suas subpastas checkpoints, loras, vae, controlnet, diffusion_models, text_encoders…), custom_nodes e user/default/workflows, onde o ComfyUI guarda os workflows salvos.

Espaço em disco

Um workflow de terceiros pode exigir vários modelos de vários gigabytes cada. Confira o tamanho informado antes de baixar tudo.

#Onde encontrar workflows do ComfyUI confiáveis

Nem todas as fontes são equivalentes. Um bom workflow para começar usa nós nativos ou extensões bem difundidas, indica os modelos necessários com seus links e tem menos de um ano. Veja as fontes em ordem decrescente de confiabilidade.

1. 01
   Os modelos integrados (templates)

   A interface atual do ComfyUI oferece uma biblioteca de workflows prontos para uso, acessível pelo menu Workflow (opção Browse Templates, ou painel Modelos, dependendo da versão e do idioma da interface). Eles abrangem texto para imagem, imagem para imagem, inpainting, upscale, ControlNet e os modelos de imagem ou vídeo com suporte oficial. Eles usam apenas nós nativos e, em muitos casos, indicam onde baixar os modelos necessários. É o melhor ponto de partida.
2. 02
   A documentação e os exemplos oficiais

   A documentação em docs.comfy.org acompanha os modelos com suporte com tutoriais e workflows para download. O site histórico de exemplos do repositório do ComfyUI (comfyanonymous.github.io/ComfyUI_examples) publica imagens PNG que contêm o próprio workflow: basta salvá-las e arrastá-las para o ComfyUI.
3. 03
   Os exemplos fornecidos pelos custom nodes

   A maioria das extensões sérias inclui workflows de exemplo no repositório do GitHub, geralmente em uma pasta example_workflows ou examples. Quando a pasta segue a convenção example_workflows, as versões recentes do ComfyUI também a exibem na biblioteca de modelos depois que a extensão é instalada. Essas são as referências mais confiáveis para aprender a usar uma extensão específica.
4. 04
   As plataformas da comunidade

   Civitai, OpenArt e outros sites compartilham milhares de workflows, em JSON ou incorporados às imagens. Lá você encontra pipelines muito bem acabados, mas também grafos carregados com dezenas de extensões, versões abandonadas e cópias de cópias. Verifique a data, o número de extensões necessárias e os comentários antes de baixar.
5. 05
   As imagens compartilhadas por outros usuários

   Uma imagem gerada pelo ComfyUI contém o próprio workflow… desde que não tenha sido recomprimida. Isso é prático em fóruns ou repositórios que disponibilizam o arquivo original, mas bem menos nas redes sociais (veja mais abaixo).

#Carregar um workflow: PNG, JSON ou atalho de teclado

O ComfyUI aceita um workflow na forma de arquivo JSON ou de imagem com metadados. Três métodos, que dão o mesmo resultado.

1. 01
   Arrastar e soltar

   Arraste o arquivo .json ou a imagem .png do seu gerenciador de arquivos para o canvas do ComfyUI. O grafo abre em uma nova aba de workflow (ou substitui o workflow atual nas interfaces antigas). É o método mais rápido para imagens.
2. 02
   Menu Workflow e depois Abrir

   Na barra superior, menu Workflow, opção Open (Abrir). Uma janela de seleção de arquivo é exibida; ela aceita JSON e imagens. Na interface antiga, o equivalente era o botão Load do painel lateral.
3. 03
   Atalho de teclado

   Ctrl+O (Cmd+O no Mac) abre a mesma janela de seleção. Os atalhos podem ser alterados nas configurações do ComfyUI: se este não responder, verifique se ele não foi reatribuído.
4. 04
   Verificar antes de executar

   Antes de clicar em Run (ou Queue Prompt), percorra o grafo: nós vermelhos, janela de aviso sobre tipos de nós ausentes, nomes de modelos que você não tem. As seções a seguir explicam como lidar com cada um desses casos.

Os workflows abertos ficam acessíveis nas abas no topo do canvas e, depois de salvos, no painel lateral Workflows. Um workflow de terceiros aberto mas não salvo desaparece se você fechar a aba dele: salve-o (Ctrl+S) assim que ele funcionar.

#A imagem não carrega nada: metadados perdidos

Você arrasta uma imagem e nada acontece, ou o ComfyUI informa que não encontra nenhum workflow. Na grande maioria dos casos, o arquivo nunca conteve um workflow ou o perdeu no caminho.

Recompressão por uma plataforma

A maioria das redes sociais e dos aplicativos de mensagens recomprime as imagens enviadas e remove seus metadados, muitas vezes convertendo-as para JPEG ou WebP. O workflow desaparece, mesmo que a imagem pareça idêntica.

Captura de tela

Uma captura de tela contém apenas pixels. Nenhuma informação de geração é preservada.

Edição ou conversão

Abrir a imagem em um editor e salvá-la novamente, ou convertê-la para JPEG, geralmente remove os blocos de texto do PNG.

Imagem de outra ferramenta

AUTOMATIC1111, Forge ou Fooocus gravam seus parâmetros em um formato diferente. O ComfyUI não reconstrói um grafo completo a partir desses dados.

Metadados desativados

O servidor que gerou a imagem pode ter sido iniciado com a opção --disable-metadata, que impede o ComfyUI de gravar o workflow nos arquivos.

Para saber se uma imagem realmente contém um workflow antes de arrastá-la, inspecione seus metadados. O ComfyUI grava dois blocos de texto nos seus PNG: prompt (formato API) e workflow (formato da interface). Com Python e a biblioteca Pillow, que já vem no ambiente do 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 o arquivo não contiver nada, nenhuma ferramenta fará o workflow reaparecer. Procure a publicação original: nas plataformas especializadas, o autor costuma anexar o JSON ou a imagem original como download separado.

#Nodes e modelos ausentes após o carregamento

#Nós vermelhos: faltam custom nodes

Se o workflow usar extensões que você não tem, o ComfyUI abre uma janela listando os tipos de nós ausentes e os exibe em vermelho no canvas. A correção é feita pelo ComfyUI Manager: menu Manager, Install Missing Custom Nodes, depois reinicialização completa do servidor e reabertura do workflow. O passo a passo detalhado, os casos em que a detecção falha e os erros IMPORT FAILED são abordados no nosso guia do ComfyUI Manager; não vamos repeti-los aqui.

Antes de instalar, veja quantas extensões a lista exige. Para fazer o inventário de um JSON sem abri-lo, a ferramenta jq lista os tipos de nós usados, inclusive nos subgrafos das versões recentes; os nomes que não lhe dizem nada provavelmente são custom nodes a identificar.

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

#Modelos não encontrados: o erro Value not in list

O grafo abre sem nenhum nó vermelho, você inicia a geração e o ComfyUI para com um erro do tipo Value not in list, citando um nome de arquivo em um campo como ckpt_name ou lora_name. O workflow exige um modelo que não está na sua pasta models, ou que está lá com outro nome.

1. 01
   Ler o nome exato solicitado

   A mensagem de erro e o nó de carregamento (Load Checkpoint, Load LoRA, Load VAE, Load Diffusion Model…) indicam o arquivo esperado. Observe também a subpasta: um arquivo guardado em checkpoints não aparecerá em um nó que lê diffusion_models.
2. 02
   Usar os links fornecidos

   Os templates oficiais e muitos workflows recentes incluem os links de download dos modelos: nesse caso, a interface oferece a opção de baixá-los, ou uma nota do workflow informa o endereço. Caso contrário, procure o nome do arquivo na página do autor, no Hugging Face ou no Civitai, verificando se é mesmo o repositório oficial do modelo.
3. 03
   Ou selecionar um equivalente

   Você já tem um modelo da mesma família? Clique no campo do nó de carregamento e escolha seu arquivo na lista. Um checkpoint SDXL substitui outro checkpoint SDXL; ele não substitui um modelo SD 1.5 nem um modelo Flux, que exigem outros nós e outras configurações.
4. 04
   Atualizar a lista

   Depois de copiar um arquivo para models, a lista dos nós nem sempre se atualiza sozinha. Use o comando de atualização da interface (tecla R por padrão) ou recarregue a página.

Pense também na memória da sua placa de vídeo. Um workflow criado em uma placa de 24 GB pode carregar ao mesmo tempo um modelo de difusão, um codificador de texto volumoso e um ControlNet, e esgotar uma placa de 8 ou 12 GB. Os autores raramente informam o hardware usado: em caso de erro de memória, procure uma versão quantizada (GGUF ou FP8) dos modelos exigidos ou remova as etapas opcionais, como o upscale.

#Cuidado com arquivos de origem desconhecida

Um arquivo de workflow é JSON: abri-lo no ComfyUI não executa nenhum programa. O risco vem do que o workflow leva você a instalar. Cada custom node é código Python que roda com as suas permissões assim que o ComfyUI é iniciado, com acesso aos seus arquivos e à rede. Extensões maliciosas já circularam: em 2024, uma extensão distribuída com o nome ComfyUI_LLMVISION foi denunciada por roubar dados dos seus usuários.

Extensões desconhecidas

Desconfie de um workflow que exige uma extensão que não está no catálogo do Manager, com um repositório recente, sem histórico nem usuários. Um workflow popular não tem motivo algum para depender de um repositório obscuro.

Instalações fora do catálogo

Se o autor pedir para clonar um repositório manualmente ou executar um script de instalação, leia o que o script faz antes de executá-lo.

Formatos de modelos

Prefira arquivos .safetensors, que contêm apenas pesos. Os formatos antigos .ckpt, .pt ou .bin costumam usar pickle, um formato Python capaz de executar código ao ser carregado.

Isolation

Para testar um workflow duvidoso, use uma instalação separada (uma segunda cópia portátil, um ambiente virtual distinto ou um contêiner), sem acesso aos seus documentos pessoais.

#Salvar, exportar e compartilhar seus workflows

Depois de consertar um workflow, salve-o para não ter que refazer o trabalho. Ctrl+S (Cmd+S no Mac) ou o menu Workflow e depois Save o salva na pasta user/default/workflows da sua instalação, e ele aparece no painel lateral Workflows. Dê a ele um nome claro: modelo, finalidade e data.

Save

Salva na biblioteca do ComfyUI, no lado do servidor. Prático no dia a dia, mas lembre-se de fazer backup dessa pasta junto com seus outros dados.

Exportação

Baixa um arquivo JSON no formato de interface para o seu computador. É o formato a ser compartilhado.

Export (API)

Baixa o formato API, útil para controlar o ComfyUI por script ou a partir de outro programa. Inútil para outro usuário da interface.

Imagem gerada

Cada imagem gerada pelo Save Image já contém o workflow. Para compartilhá-la com o grafo, envie o arquivo PNG original, como anexo ou em um arquivo compactado, nunca uma versão recomprimida.

Para compartilhar de forma adequada, adicione um nó Note que liste os modelos usados com seus links, as extensões necessárias e a memória de vídeo com a qual o workflow foi desenvolvido. Verifique também se seus prompts e nomes de arquivos não revelam nada pessoal: eles viajam junto com o workflow, inclusive nos metadados das imagens. Por fim, um workflow publicado continua sendo obra do seu autor: se você compartilhar uma versão modificada, cite a publicação original e inclua um link para ela, em vez de republicar o arquivo como está.

#Solução rápida de problemas

Arrastar a imagem não faz nada

O arquivo não contém workflow: recompressão, captura de tela, conversão ou imagem de outra ferramenta. Confira com o script Python acima.

Janela de tipos de nós ausentes

Faltam custom nodes. Manager, Install Missing Custom Nodes, reinicialização completa e, em seguida, reabertura do workflow.

Nós continuam vermelhos após a instalação

O servidor não foi reiniciado, a extensão falhou ao carregar (IMPORT FAILED no terminal) ou o nó foi renomeado. Detalhes no guia do ComfyUI Manager.

Erro Value not in list

Modelo ausente ou guardado na subpasta errada de models. Baixe-o ou escolha um equivalente da mesma família no nó.

Entradas desalinhadas ou valores absurdos

Workflow criado para outra versão de um nó. Atualize o ComfyUI e a extensão em questão, ou recrie o nó manualmente e conecte-o.

Erro de memória (out of memory)

O workflow excede a memória da sua placa. Use uma versão quantizada dos modelos, uma resolução mais baixa ou remova as etapas opcionais.

Resultado diferente da imagem original

Seed, versão dos modelos, LoRA ou sampler são diferentes. Mesmo com um workflow idêntico, duas máquinas não produzem necessariamente a mesma imagem pixel a pixel.

#Para se aprofundar

Carregar ComfyUI workflows logo se torna natural depois que a instalação, o Manager e a organização dos modelos estão prontos. Estes guias complementam este: instalar o ComfyUI corretamente, gerenciar os custom nodes, escolher sua ferramenta de geração de imagens local e dominar o ControlNet, um componente presente em muitos workflows compartilhados.