Pesquisar
Português
Conteúdo
  1. Tutorial de ComfyUI
Primeiros passos
  1. O que é ComfyUI
  2. Instalar o ComfyUI
  3. Visão geral da interface
  4. Download de modelos e pastas
  5. Primeira imagem (texto em imagem)
Técnicas essenciais
  1. Parâmetros do KSampler
  2. Técnicas de prompt
  3. Imagem para imagem (img2img)
  4. Inpainting e outpainting
  5. LoRA
  6. ControlNet
  7. Upscale de imagens
Recursos avançados
  1. Nós personalizados e Manager
  2. Modelos de nova geração, como Flux
  3. Geração de vídeos com IA
  4. Automatizar com a API
  5. Perguntas frequentes e erros

Instalação do ComfyUI: Desktop, versão portátil para Windows e instalação manual

Há várias maneiras de instalar o ComfyUI. Escolha a que melhor atende ao seu computador e às suas necessidades:

MétodoIndicado paraSistema
DesktopPrimeiro uso, para começar rapidamenteWindows, macOS
Versão portátil para Windows (portable)Quem quer manter todo o ambiente em uma pasta e transferi-lo com facilidadeWindows
Instalação manualLinux, servidores e quem quer controle total do ambienteTodos

Método 1: ComfyUI Desktop (recomendado para iniciantes)

  1. Baixe a versão Desktop no site oficial do ComfyUI (comfy.org).
  2. Execute o instalador e siga as etapas do assistente:
    • Escolha o tipo de GPU (NVIDIA, Apple Silicon etc.).
    • Escolha o local de instalação (recomendamos um disco com bastante espaço, pois os modelos serão armazenados nele).
    • Se você já tiver instalado o ComfyUI, poderá importar os modelos e as configurações existentes.
  3. O instalador baixará o Python e os pacotes necessários automaticamente. Ao terminar, abra a interface.

A versão Desktop inclui o ComfyUI-Manager (gerenciador de nós personalizados) e atualizações automáticas.

Método 2: versão portátil para Windows

  1. Baixe o arquivo compactado da versão portátil na página do ComfyUI no GitHub (Releases). Escolha a versão correspondente à sua placa de vídeo (principalmente NVIDIA; também há versões para AMD e Intel).
  2. Use o 7-Zip para extrair os arquivos em um local com bastante espaço, por exemplo, D:\ComfyUI_windows_portable. Evite caracteres acentuados e espaços no caminho.
  3. Execute um dos arquivos na pasta:
    • run_nvidia_gpu.bat: usa uma placa de vídeo NVIDIA.
    • run_cpu.bat: usa apenas a CPU (muito lento).
  4. Quando a janela do terminal exibir To see the GUI go to: http://127.0.0.1:8188, abra esse endereço no navegador.

A versão portátil inclui um Python próprio e não afeta os outros programas do computador. Para atualizar, execute o script de atualização na pasta update.

Placas de vídeo NVIDIA muito antigas (por exemplo, da série GTX 10) talvez exijam uma versão que o site oficial indique como compatível com placas antigas.

Método 3: instalação manual

Indicado para Linux ou para quem quer gerenciar o ambiente por conta própria. Primeiro, instale o Git e o Python (recomendamos a versão indicada no README oficial, atualmente entre 3.12 e 3.13).

git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI
python -m venv venv
source venv/bin/activate          # Windows: venv\Scripts\activate

Instalar o PyTorch

Instale a versão do PyTorch correspondente à sua placa de vídeo (os números das versões mudam com o tempo; consulte o README do ComfyUI ou o site oficial do PyTorch):

# NVIDIA
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

# AMD（Linux，ROCm）
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2

# Placa de vídeo Intel
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu

Em Macs com Apple Silicon, instale o PyTorch seguindo as instruções do Apple PyTorch Metal.

Instalar as dependências e iniciar

pip install -r requirements.txt
python main.py

Abra http://127.0.0.1:8188.

Você também pode usar o comfy-cli

pip install comfy-cli
comfy install
comfy launch

Parâmetros de inicialização comuns

python main.py --listen 0.0.0.0 --port 8188
ParâmetroDescrição
--listen 0.0.0.0Permite conexões de outros computadores da rede local (por padrão, apenas o computador local)
--port 8188Define a porta
--lowvramUse quando a memória da placa de vídeo for insuficiente; a velocidade será menor
--cpuUsa apenas a CPU
--preview-method autoExibe imagens de prévia durante a geração
--enable-managerAtiva o ComfyUI-Manager (na instalação manual, instale primeiro as dependências dele)

Para adicionar parâmetros à versão portátil, use um editor de texto para modificar a linha python main.py em run_nvidia_gpu.bat.

Ao usar --listen para permitir conexões de outros computadores, lembre-se de que o ComfyUI não tem proteção por nome de usuário e senha. Use-o apenas em uma rede interna confiável.

Verificar se a GPU está sendo usada

As mensagens do terminal durante a inicialização mostram os dispositivos detectados, por exemplo:

Total VRAM 12288 MB, total RAM 32671 MB
Device: cuda:0 NVIDIA GeForce RTX 4070 : cudaMallocAsync

Se aparecer CPU, isso significa que a versão do PyTorch com suporte à GPU não foi instalada corretamente.

Atualização

  • Desktop: avisa automaticamente quando há uma atualização.

  • Versão portátil: execute update/update_comfyui.bat.

  • Instalação manual:

    git pull
pip install -r requirements.txt

Se um nó personalizado apresentar problemas após a atualização, normalmente ele também precisa ser atualizado. Consulte Nós personalizados e Manager.

Próximos passos

Depois da instalação, o ComfyUI ainda não pode gerar imagens, pois você ainda não tem um modelo. Confira primeiro o Tour pela interface e depois acesse Download de modelos e pastas para baixar seu primeiro modelo.

Atualizado 12 de outubro de 2026