Instalar o ComfyUI e gerar a primeira imagem

O Comfy Desktop é a aplicação oficial para computador do ComfyUI e instala simultaneamente o ComfyUI e o ambiente de execução necessário, sem ser preciso configurar Python, CUDA ou pip separadamente. Também pode manter várias instalações no mesmo computador, independentes umas das outras, o que é útil para experimentar versões ou configurações diferentes.

Antes de começar

Confirme primeiro se o computador cumpre os seguintes requisitos:

• Windows 10 ou posterior, com suporte para x64 ou ARM64. Recomenda-se uma placa gráfica dedicada NVIDIA ou AMD, mas também é possível instalar sem uma placa gráfica dedicada.
• macOS 13 (Ventura) ou posterior, obrigatoriamente num computador com Apple Silicon (M1 ou posterior).
• Linux. Estão disponíveis pacotes .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; 16 GB proporcionam uma utilização mais adequada. Os modelos de imagem que transferir posteriormente também ocuparão espaço adicional em disco.

macOS

Abra o dmg

• Arraste para Aplicações
• Na primeira vez, aceda a 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 página de boas-vindas

Linux

deb ou AppImage

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

Instalar e iniciar pela primeira vez

Aceda à página de transferência do Comfy Desktop para obter o pacote de instalação. A página identifica automaticamente o sistema que está a utilizar.

macOS

1. Abra o ficheiro .dmg transferido.
2. Arraste o Comfy Desktop para a pasta Aplicações.
3. Abra o Comfy Desktop através do Launchpad ou do Spotlight.

No primeiro arranque, o macOS poderá apresentar um aviso de segurança. Nesse caso, abra Privacy & Security (Privacidade e segurança) nas Definições do Sistema e clique em Open Anyway (Abrir mesmo assim). Este botão permite ao sistema iniciar a aplicação que acabou de ser bloqueada.

Windows

Execute o ficheiro .exe transferido, que utiliza o instalador NSIS, e siga as instruções apresentadas para concluir a instalação. Em seguida, abra o Comfy Desktop através do menu Iniciar ou do atalho no ambiente de trabalho.

No primeiro arranque, será apresentado o ecrã de boas-vindas, onde poderá criar a primeira instalação do ComfyUI.

Linux

No Linux, utilize a ligação de transferência genérica. Os utilizadores de Debian ou Ubuntu devem abrir o diretório de transferências onde se encontra o pacote de instalação e executar:

sudo apt install ./*.deb

Para utilizar a AppImage, execute:

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

Se a aplicação não iniciar, é possível que a distribuição Linux esteja a bloquear a sandbox do Electron. O Ubuntu 24.04 e versões posteriores restringem os espaços de nomes de utilizadores sem privilégios através do AppArmor. Adicione --no-sandbox e tente novamente apenas depois de confirmar que a falha de arranque é causada pela sandbox. Este parâmetro desativa a sandbox do Electron em cada processo e não é recomendado noutras situações.

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

Por predefinição, a versão para computador acompanha a versão estável. Se pretender acompanhar cada commit mais recente no GitHub, pode utilizar a versão portátil, efetuar uma instalação manual com git ou alterar o canal de atualização da instância para Latest on GitHub.

Obter os parâmetros de ligação no OmniProxy

Não existem aqui um endereço, uma chave ou um ID de modelo genéricos que possam ser introduzidos. A instalação do Comfy Desktop e o fluxo básico de geração de imagens a partir de texto não requerem o OmniProxy.

Não introduza o Base URL de outras ferramentas em nós cuja origem não seja clara. Aguarde até existirem instruções explícitas para uma integração genérica antes de configurar esta ligação separadamente.

Introduzir a configuração da ferramenta

Não existe aqui um formulário de configuração do OmniProxy. Para gerar a primeira imagem, precisa de preparar primeiro um workflow e um modelo de imagem.

Um workflow pode ser entendido como um conjunto de passos para gerar uma imagem. Os nós são os módulos operacionais responsáveis por tarefas como carregar o modelo, receber texto ou guardar imagens. Depois de iniciado, o ComfyUI carrega normalmente e de forma automática o workflow predefinido de geração de imagens a partir de texto.

Se precisar de abrir outro workflow, selecione Workflows → Open no menu. Esta opção permite carregar uma imagem que contenha informações do workflow ou um ficheiro JSON de workflow.

A maioria das instalações não inclui um modelo base por predefinição. Depois de carregar o workflow, se o computador não tiver v1-5-pruned-emaonly-fp16.safetensors, a interface indicará que falta um modelo. Abra o aviso para consultar o modelo em falta e a respetiva ligação de transferência.

Para consultar o diretório de modelos utilizado pela instalação atual, clique no menu em forma de cápsula na parte superior e abra Storage. Esta área permite ver onde os modelos e outros ficheiros estão realmente guardados. O menu em forma de cápsula na parte superior só está disponível na aplicação para computador. Clique no ícone de pasta junto ao diretório para o abrir diretamente no gestor de ficheiros do sistema.

Existem duas formas de transferir o modelo:

• Clique em Download na interface. Este botão inicia a transferência do modelo em falta. A versão para computador guarda o modelo em ComfyUI/models/checkpoints na instalação atual. Pode acompanhar o progresso da transferência no painel de modelos da barra lateral. Normalmente, a transferência automática é efetuada a partir do Hugging Face, pelo que a rede tem de conseguir aceder ao Hugging Face.
• Se não houver progresso durante muito tempo, copie a ligação de transferência apresentada nos detalhes do modelo em falta, transfira manualmente o ficheiro e guarde-o no mesmo diretório checkpoints. Em seguida, atualize ou reinicie o ComfyUI.

Depois de colocar o modelo no local correto, prima R no teclado para que a interface volte a ler a lista de modelos dos nós.

Aplicação

Comfy Desktop

• Gere a instalação do ambiente
• Use a página de boas-vindas ou crie uma nova instância
• Clique no cartão para iniciar

Fluxo de trabalho

Texto para imagem

• Normalmente, é carregado automaticamente
• Também pode abri-lo a partir do menu
• É apresentado um aviso se faltar um modelo

Modelo

checkpoints

• Transfira-o através da ligação apresentada no aviso
• A versão para computador pode guardá-lo automaticamente
• Prima R para atualizar a lista

Verificar uma tarefa real

Depois de preparar o modelo, siga estes passos para tentar gerar a primeira imagem:

1. No nó Load Checkpoint, selecione v1-5-pruned-emaonly-fp16.safetensors. Este nó carrega o modelo que será utilizado para gerar a imagem.
2. Clique em Run ou prima Ctrl + Enter. Run inicia a execução da tarefa atual de geração de imagem.
3. O resultado gerado será apresentado no nó Save Image. Este nó permite pré-visualizar e guardar a imagem final. Pode clicar na imagem com o botão direito do rato para a guardar no computador.

Se não aparecer nenhum modelo em Load Checkpoint ou se a lista pendente apresentar null, confirme primeiro o diretório dos modelos e, depois, atualize ou reinicie o ComfyUI.

Até 2026-10-09, foi confirmado no macOS que o Comfy Desktop 1.1.6 obtido através do dmg oficial consegue iniciar. Como ainda é necessário criar uma instalação dentro da aplicação e transferir o modelo de checkpoint, o processo da primeira geração não foi concluído. Por esse motivo, não se afirma aqui que uma imagem tenha sido gerada com êxito, nem foi efetuada a integração do OmniProxy com o ComfyUI.

Modelo

O nome aparece na lista pendente

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

Geração

Clique em Run

• Ou prima Ctrl+Enter
• Aguarde até todos os nós terminarem
• A imagem está em Save Image

Limites

Não ligue ainda ao gateway

• Não existe um campo de configuração genérico
• Não instale nós de origem desconhecida
• Basta conseguir gerar a imagem

Erros comuns

• O macOS não permite abrir a aplicação: aceda a Definições do Sistema → Privacidade e segurança e clique em Abrir mesmo assim. O pacote de instalação só é compatível com Apple Silicon e macOS 13 ou posterior.
• A aplicação fecha imediatamente no Linux: confirme primeiro se está a utilizar o pacote .deb ou a AppImage. Adicione --no-sandbox apenas depois de confirmar que a falha de arranque é causada pela sandbox.
• É apresentado um aviso de modelo em falta: utilize a ligação do aviso para transferir o modelo de checkpoint, guarde-o em models/checkpoints na instalação atual e prima R para atualizar.
• A lista pendente de modelos apresenta null: utilize Storage para confirmar o diretório dos modelos, verifique se o ficheiro foi colocado no local correto e, depois, atualize ou reinicie a aplicação.
• Pretende introduzir aqui os dados do OmniProxy: atualmente não existe um campo de integração genérico. Não instale nós adicionais que não estejam explicitamente identificados como um método de integração genérico.

Referências oficiais

Consulte Comfy Desktop para obter uma visão geral da instalação. Os passos de instalação para cada plataforma estão disponíveis em macOS, Windows e Linux. Consulte Using Comfy Desktop para saber como utilizar a interface para computador. Os passos para gerar a primeira imagem estão disponíveis em Getting Started with AI Image Generation.

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

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

Fontes oficiais · ComfyUI ↗