Como instalar o ComfyUI e gerar sua primeira imagem

O Comfy Desktop é o aplicativo oficial para desktop do ComfyUI. Ele instala o ComfyUI e o ambiente de execução necessário, sem exigir que você configure Python, CUDA ou pip separadamente. Também é possível manter várias instalações independentes no mesmo computador, o que é útil para testar diferentes versões ou configurações.

Preparação antes da instalação

Primeiro, confirme se o computador atende aos seguintes requisitos:

• Windows 10 ou posterior, com suporte a x64 ou ARM64. Recomenda-se uma placa de vídeo dedicada NVIDIA ou AMD, mas também é possível instalar sem uma GPU dedicada.
• macOS 13 (Ventura) ou posterior, obrigatoriamente em um computador com Apple Silicon (M1 ou mais recente).
• Linux. Os pacotes estão disponíveis nos formatos .deb e AppImage. Recomenda-se Ubuntu 22.04 ou posterior, com arquitetura x64.

Cada instalação do ComfyUI requer aproximadamente 4,85 GB de espaço em disco. Prepare pelo menos 8 GB de memória RAM; 16 GB oferecem uma experiência mais adequada. Os modelos de imagem baixados posteriormente ocuparão espaço adicional em disco.

macOS

Abra o dmg

• Arraste para Aplicativos
• Na primeira vez, acesse Privacidade e Segurança
• Clique em Abrir Mesmo Assim

Windows

Execute o exe

• Windows 10 ou mais recente
• x64 ou ARM64
• Crie a instalação na tela de boas-vindas

Linux

deb ou AppImage

• Recomenda-se Ubuntu 22.04+
• x64
• Se não iniciar, consulte as instruções do sandbox

Instalação e primeira inicialização

Acesse a página de download do Comfy Desktop para obter o instalador. A página detectará automaticamente o sistema que você está usando.

macOS

1. Abra o arquivo .dmg baixado.
2. Arraste o Comfy Desktop para a pasta Aplicativos.
3. Abra o Comfy Desktop pelo Launchpad ou pela busca do Spotlight.

Na primeira inicialização, o macOS pode exibir um aviso de segurança. Nesse caso, abra Privacy & Security (Privacidade e Segurança) nos ajustes do sistema e clique em Open Anyway (Abrir Mesmo Assim). Esse botão permite que o sistema execute o aplicativo que acabou de ser bloqueado.

Windows

Execute o arquivo .exe baixado, que é um instalador NSIS, e siga as instruções na tela para concluir a instalação. Depois, abra o Comfy Desktop pelo menu Iniciar ou pelo atalho da área de trabalho.

Na primeira inicialização, será exibida a tela de boas-vindas, na qual você poderá criar sua primeira instalação do ComfyUI.

Linux

No Linux, use o link de download genérico. Usuários de Debian ou Ubuntu devem abrir o diretório de downloads em que está o pacote de instalação e executar:

sudo apt install ./*.deb

Para usar o AppImage, execute:

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

Se o aplicativo não iniciar, talvez a distribuição Linux esteja bloqueando o sandbox do Electron. O Ubuntu 24.04 e versões posteriores restringem namespaces de usuários sem privilégios por meio do AppArmor. Adicione --no-sandbox e tente novamente somente depois de confirmar que a falha ocorreu ao iniciar o sandbox. Esse parâmetro desativa o sandbox do Electron em cada processo e não é recomendado em outras situações.

Depois de abrir o Comfy Desktop, a página Chooser exibirá as instâncias já existentes. Clique em New Instance para criar uma nova instalação independente do ComfyUI e, em seguida, clique no cartão da instância correspondente para iniciá-la.

Por padrão, a versão para desktop acompanha a versão estável. Se quiser acompanhar cada commit mais recente no GitHub, você pode usar a versão portátil, fazer uma instalação manual com git ou mudar o canal de atualização da instância para Latest on GitHub.

Obtenção dos parâmetros de conexão no OmniProxy

Não há um endereço, uma chave ou um ID de modelo genérico que possa ser informado aqui. A instalação do Comfy Desktop e a conclusão do fluxo básico de texto para imagem não exigem o OmniProxy.

Não informe a Base URL de outras ferramentas em nós de origem desconhecida. Aguarde até que existam instruções claras de integração genérica para fazer essa configuração separadamente.

Preenchimento da configuração da ferramenta

Não há um formulário de configuração do OmniProxy nesta etapa. Para gerar a primeira imagem, prepare primeiro um workflow e um modelo de imagem.

Um workflow pode ser entendido como uma sequência de etapas para gerar uma imagem. Os nós são os módulos de operação responsáveis por tarefas como carregar o modelo, receber o texto ou salvar a imagem. Depois que o ComfyUI é iniciado, normalmente o workflow padrão de texto para imagem é carregado automaticamente.

Se precisar abrir outro workflow, selecione Workflows → Open no menu. Essa opção carrega uma imagem que contém informações do workflow ou um arquivo de workflow em JSON.

A maioria das instalações não inclui um modelo básico por padrão. Depois de carregar o workflow, se v1-5-pruned-emaonly-fp16.safetensors não estiver no computador, a interface avisará que o modelo está ausente. Abra o aviso para consultar o modelo que está faltando e o respectivo link de download.

Para conferir o diretório de modelos usado pela instalação atual, clique no menu em formato de cápsula na parte superior e abra Storage. Essa seção permite verificar onde arquivos como os modelos estão realmente armazenados. O menu superior em formato de cápsula está disponível somente no aplicativo para desktop. Clique no ícone de pasta ao lado do diretório para abri-lo diretamente no gerenciador de arquivos do sistema.

Há duas maneiras de baixar o modelo:

• Clique em Download na interface. Esse botão inicia o download do modelo ausente. A versão para desktop salvará o modelo em ComfyUI/models/checkpoints na instalação atual. O progresso do download pode ser acompanhado no painel de modelos da barra lateral. O download automático geralmente é feito pelo Hugging Face, portanto a rede precisa conseguir acessar o Hugging Face.
• Se o download ficar muito tempo sem avançar, copie o link de download exibido nos detalhes do modelo ausente, baixe o arquivo manualmente e salve-o no mesmo diretório checkpoints. Em seguida, atualize ou reinicie o ComfyUI.

Depois de colocar o modelo no diretório correto, pressione R no teclado para que a interface releia a lista de modelos dos nós.

Aplicativo

Comfy Desktop

• Ele instala o ambiente
• Use a tela de boas-vindas ou crie uma instância
• Clique no cartão para iniciar

Fluxo de trabalho

Texto para imagem

• Geralmente é carregado automaticamente
• Também pode ser aberto pelo menu
• Um aviso aparece se faltar um modelo

Modelo

checkpoints

• Baixe pelo link exibido no aviso
• A versão para desktop pode salvar automaticamente
• Pressione R para atualizar a lista

Verificação com uma tarefa real

Depois de preparar o modelo, siga estas etapas para tentar gerar sua primeira imagem:

1. No nó Load Checkpoint, selecione v1-5-pruned-emaonly-fp16.safetensors. Esse nó carrega o modelo que será usado nesta geração.
2. Clique em Run ou pressione Ctrl + Enter. O botão Run inicia a execução da tarefa de geração atual.
3. O resultado gerado aparecerá no nó Save Image. Esse nó permite visualizar e salvar a imagem final. Você pode clicar na imagem com o botão direito para salvá-la no computador.

Se nenhum modelo aparecer em Load Checkpoint ou se a lista suspensa mostrar null, confira primeiro o diretório de modelos e depois atualize ou reinicie o ComfyUI.

Até 2026-10-09, foi confirmado no macOS que o Comfy Desktop 1.1.6 obtido pelo dmg oficial consegue iniciar. Como ainda é necessário criar uma instalação dentro do aplicativo e baixar o modelo de checkpoint, o fluxo da primeira geração não foi concluído. Portanto, não se afirma aqui que uma imagem tenha sido gerada com sucesso, e o OmniProxy também não foi integrado ao ComfyUI.

Modelo

O nome aparece no menu

• Não é null
• Selecione o checkpoint
• Pressione R para atualizar

Geração

Clique em Run

• Ou pressione Ctrl+Enter
• Aguarde a execução dos nós
• A imagem fica em Save Image

Limites

Não conecte ao gateway ainda

• Não há um campo de configuração geral
• Não instale nós de origem desconhecida
• Basta gerar a imagem com sucesso

Erros comuns

• O aplicativo não abre no macOS: acesse Ajustes do Sistema → Privacidade e Segurança e clique em Abrir Mesmo Assim. O instalador é compatível somente com Apple Silicon e macOS 13 ou posterior.
• O aplicativo fecha imediatamente no Linux: primeiro confirme se você está usando o arquivo .deb ou AppImage. Adicione --no-sandbox somente depois de confirmar que houve uma falha ao iniciar o sandbox.
• Aviso de modelo ausente: use o link exibido no aviso para baixar o modelo de checkpoint, salve-o em models/checkpoints na instalação atual e pressione R para atualizar.
• A lista suspensa de modelos mostra null: confira o diretório de modelos em Storage, confirme se o arquivo foi colocado no local correto e depois atualize ou reinicie.
• Você quer informar o OmniProxy aqui: atualmente não há um campo de integração genérica. Não instale nós adicionais que não tenham sido claramente indicados como uma forma genérica de integração.

Referências oficiais

Para uma visão geral da instalação, consulte Comfy Desktop. As etapas de instalação de cada plataforma estão disponíveis em macOS, Windows e Linux. Para saber como usar a interface para desktop, consulte Using Comfy Desktop. As etapas da primeira geração estão em Getting Started with AI Image Generation.

Substitua todos os espaços reservados por valores de sua própria configuração do OmniProxy. Nunca publique uma chave real.

Um resultado salvo ou HTTP 200 sozinho não prova compatibilidade total com o Agente. Verifique a origem e o modelo no registro de chamadas do OmniProxy.

Fontes oficiais · ComfyUI ↗