ComfyUI: instalação e primeiros passos localmente (2026)

#O que é o ComfyUI?

ComfyUI é um software livre (licença GPL-3.0), cujo repositório foi criado em janeiro de 2023 e que atualmente é mantido pela organização Comfy Org; ele ultrapassa 130.000 estrelas no GitHub. Ele é instalado no seu computador e aberto no navegador no endereço http://127.0.0.1:8188. O cálculo é feito na sua placa de vídeo, e o README especifica que o núcleo do software não baixa nada a menos que você solicite.

Seu diferencial é mostrar o pipeline em vez de ocultá-lo. Enquanto uma interface clássica oferece um campo de texto e um botão, o ComfyUI exibe cada etapa como um nó: carregar o modelo, codificar o prompt, remover o ruído, decodificar a imagem e salvá-la. Você conecta os nós por fios. O conjunto forma um workflow, que pode ser salvo, compartilhado e executado novamente de forma idêntica.

O README anuncia uma versão estável principal aproximadamente a cada duas semanas. Esse detalhe importa para a instalação: o aplicativo Desktop segue por padrão a versão estável, enquanto a versão portátil e a instalação via Git seguem os commits mais recentes, que, como alerta o README, podem quebrar muitas extensões.

• Panorama: todas as formas de gerar imagens localmente

#O hardware de que você precisa

Como no caso de um LLM, a memória da placa de vídeo determina tudo. O ComfyUI, porém, relativiza essa regra: seu README anuncia que até os maiores modelos abertos rodam “relativamente rápido” com 4 GB de VRAM e 8 GB de RAM, graças ao carregamento assíncrono dos pesos. É um anúncio, não uma medição: quanto maior a parte dos pesos que não cabe na VRAM, mais tempo é gasto nas transferências de ida e volta. A tabela parte, portanto, do que é verificável: o tamanho dos arquivos publicados no Hugging Face.

Quanto aos fabricantes, NVIDIA continua sendo o caminho sem obstáculos. As placas AMD funcionam bem no Linux com ROCm e, desde janeiro de 2026, a própria equipe do ComfyUI anuncia que o suporte oficial ao ROCm « is now available on the Windows ComfyUI Desktop app, starting with version v0.7.0 », para as Radeon e os processadores Ryzen AI compatíveis. Por fim, reserve espaço no disco: um único modelo ocupa de 2 a 25 GB, e é fácil acumular cerca de dez deles.

• VRAM: o que é e como descobrir qual é a sua
• Qual GPU escolher para IA local

#Três formas de instalá-lo

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

Ao iniciar, o terminal exibe o endereço local para abrir no navegador. Se o terminal indicar "Torch not compiled with CUDA enabled", o README orienta a desinstalar o torch (pip uninstall torch) e depois reinstalá-lo com o comando acima.

#Gerenciamento de memória: as opções que importam em 2026

A gestão da VRAM mudou. No código do ComfyUI, a "dynamic VRAM" está ativada por padrão, a menos que você imponha --highvram, --novram ou --cpu, ou a desative com --disable-dynamic-vram; a ajuda de --enable-dynamic-vram sugere que alguns sistemas não a têm ativada por padrão. A ajuda de --lowvram é explícita: a opção não faz nada enquanto a VRAM dinâmica estiver ativa. Portanto, o conselho antigo de adicionar --lowvram em uma placa de 6 GB já não se aplica tal como era.

--reserve-vram X

Reserva X GB de VRAM para o sistema e outros softwares: útil se o computador também for usado para exibição ou para um LLM.

--disable-dynamic-vram

Volta para o carregamento clássico baseado em estimativas: tentar em caso de falha relacionada à memória.

--novram e --cpu

Últimos recursos: a ajuda descreve --novram como a opção “quando lowvram não é suficiente” e --cpu como “slow”. Espere uma geração significativamente mais lenta.

--listen

Por padrão, o ComfyUI ouve apenas em 127.0.0.1. Sem argumento, --listen abre todas as interfaces de rede: deve ser usado apenas em redes de confiança, veja a seção sobre segurança.

#Onde armazenar os modelos

O ComfyUI não inclui nenhum modelo. Essa é a principal causa de dificuldades para começar: a interface abre, você clica em Executar e um erro indica que falta um arquivo. Cada tipo de arquivo tem sua própria subpasta dentro da pasta models.

models/checkpoints

Modelos « tudo em um » como o SDXL: um único arquivo .safetensors contém o modelo de difusão, o codificador de texto e o VAE. É a forma mais simples de começar.

models/diffusion_models

Apenas o modelo de difusão, para as famílias recentes distribuídas em componentes separados (Flux, Z-Image, Wan).

models/text_encoders

O codificador que transforma seu prompt em vetores. Muitas vezes, é o maior arquivo depois do próprio modelo.

models/vae

O decodificador que transforma o resultado do cálculo em imagem visível

models/loras

LoRA: pequenos arquivos que adicionam um estilo, um personagem ou um conceito a um modelo base.

#Reutilizar modelos de outra interface

Se você já tem checkpoints com AUTOMATIC1111 ou Fooocus, não é necessário copiá-los. O README fornece um arquivo extra_model_paths.yaml.example na raiz do ComfyUI: renomeie-o para extra_model_paths.yaml, indique o caminho das pastas existentes, e o ComfyUI lerá os checkpoints sem duplicá-los. No pacote portátil para Windows, esse arquivo fica na pasta ComfyUI.

#Sua primeira imagem

1. 01
   Carregar um workflow oficial

   No menu de modelos de fluxos de trabalho, escolha a geração básica de imagens correspondente à sua VRAM: SDXL a partir de 8 GB, um modelo recente em FP8 a partir de 12 GB.
2. 02
   Baixar os arquivos propostos

   Aceite os downloads. Verifique no terminal se eles terminam sem erro: uma interrupção de rede deixa um arquivo truncado que causará um erro obscuro mais tarde.
3. 03
   Escrever o prompt

   O nó de codificação de texto ligado à entrada "positive" contém a descrição da imagem. O ligado à entrada "negative" lista o que você não quer ver. A maioria dos modelos entende melhor o inglês.
4. 04
   Executar

   Clique em Executar. Os nós acendem um após o outro. A primeira geração é lenta porque é preciso carregar o modelo na VRAM; as seguintes são muito mais rápidas.
5. 05
   Encontrar a imagem

   Ela aparece no nó de salvamento e fica na pasta output. O arquivo PNG contém o workflow completo que a gerou.

Três ajustes no nó de amostragem são suficientes para começar. A semente (seed) determina a imagem: a mesma semente e os mesmos ajustes geram a mesma imagem. O número de passos (steps) controla o tempo de cálculo, de 20 a 30 para um modelo clássico, de 4 a 8 para um modelo « turbo ». O CFG controla a fidelidade ao prompt: se estiver alto demais, a imagem fica saturada e distorcida.

#Entender e recuperar workflows

Um workflow é um simples arquivo JSON, e o ComfyUI registra esse arquivo em cada imagem que ele salva. Arraste para a janela um PNG gerado pelo ComfyUI, e o grafo completo que o gerou será recarregado, com o prompt, a semente e todos os ajustes. A documentação oficial apresenta essa opção como uma das duas formas de carregamento em seu primeiro tutorial. É a melhor forma de aprender.

Quando um workflow recuperado exibe nós vermelhos, ele está usando extensões que você não possui. O ComfyUI-Manager lista e instala essas extensões. Agora está integrado ao repositório principal, mas permanece opcional: ativa-se com a opção --enable-manager, após a instalação do manager_requirements.txt. Seja cauteloso: cinquenta extensões acabam quebrando uma instalação na primeira atualização.

#Nós maliciosos e instâncias expostas: o risco real

O alerta sobre o código que é executado não é teórico. Em 10 de janeiro de 2026, uma issue no repositório oficial, intitulada “Malicious Distribution of Akira Stealer via 'Upscaler_4K' Custom Nodes in Comfy Registry”, documentou uma série de nós publicados no Comfy Registry sob o disfarce de um “Upscaler_4K”. A lógica maliciosa, escondida em uma pasta de scripts para escapar dos scanners do registro, visava, no Windows, dados de navegadores, carteiras de criptomoedas e tokens do Discord. A issue registra 779 instalações possíveis.

Segundo risco, independente das extensões do registro: a exposição na Internet. Em abril de 2026, o The Hacker News relatou, com base em um relatório da Censys, uma campanha direcionada a instâncias do ComfyUI acessíveis publicamente: mais de 1.000 haviam sido identificadas. O scanner explora nós personalizados que executam código sem autenticação e, se o ComfyUI-Manager estiver presente, ele próprio instala um nó vulnerável antes de tentar novamente. As máquinas comprometidas mineravam Monero e Conflux e alimentavam uma botnet.

Antes de instalar uma extensão

Use o ComfyUI-Manager em vez de um link encontrado em um fórum, verifique o número de instalações e a data da última atualização e evite qualquer nó que prometa um atalho bom demais para ser verdade (« upscaler mágico », « desbloqueio » de um modelo comercial).

Se você usar --listen

Nunca exponha o ComfyUI à internet sem uma camada de autenticação à frente dele: um proxy reverso com senha ou, melhor ainda, uma VPN. Sem isso, sua máquina entra na lista de alvos varridos automaticamente.

Para desativar os serviços online

A opção --disable-api-nodes desativa os nós de API pagos do Comfy e impede a interface de se comunicar com a Internet, conforme indicado na ajuda da linha de comando.

• Fonte: o relato oficial da campanha Akira Stealer
• Fonte: The Hacker News sobre instâncias do ComfyUI comprometidas
• Fonte: anúncio do suporte oficial ROCm no Windows

#Erros nos primeiros dias

Erro de memória (CUDA out of memory)

O modelo ou a resolução ultrapassam a sua VRAM. Reduza o tamanho da imagem, use uma versão FP8 ou quantizada, reserve espaço com --reserve-vram ou tente --disable-dynamic-vram.

Imagem preta ou ruído colorido

Quase sempre é um VAE ou um codificador de texto que não corresponde ao modelo. Recomece a partir do workflow oficial da família em questão.

Geração interminável

Verifique no terminal se a GPU é detectada ao iniciar o ComfyUI. Se o ComfyUI indicar que está funcionando na CPU, a versão do PyTorch instalada não corresponde à sua placa.

Torch not compiled with CUDA enabled

Desinstale o torch (pip uninstall torch) e reinstale com o comando do README para sua placa.

Nós vermelhos ao abrir um workflow

Faltam extensões. Use o gerenciador para instalá-las e, em seguida, reinicie o ComfyUI.

#Licenças: o que você tem o direito de fazer

O ComfyUI é livre, mas cada modelo tem sua própria licença, e muitas vezes há confusão: a licença do modelo não é a das imagens que ele gera. Antes de usar uma imagem para um cliente, produto ou publicidade, leia a ficha do modelo que a gerou.

• O kit de imagens IA: workflows prontos para uso e configurações por placa de vídeo
• Documentação oficial do ComfyUI
• O repositório ComfyUI no GitHub

#FAQ