ComfyUI Manager: instalar nodes, reparar os erreurs

#Para que serve o ComfyUI Manager

Por padrão, o ComfyUI só sabe fazer o que seus nós integrados permitem. Todo o restante — ControlNet avançado, pré-processadores, ampliadores, ferramentas de vídeo e nós de conveniência — vem de extensões chamadas custom nodes. Cada custom node é um repositório Git contendo código Python, colocado na pasta custom_nodes da sua instalação e carregado na inicialização.

Sem o Manager, instalar uma extensão equivale a clonar um repositório manualmente, instalar suas dependências Python no ambiente correto e reiniciar. O Manager executa essas etapas a partir de uma janela da interface. Ele oferece principalmente três funções que acabamos sempre usando: detectar os nodes ausentes de um workflow, um botão de reparo para os nodes que se recusam a carregar e instantâneos para voltar atrás após uma atualização mal-sucedida.

Custom Nodes Manager

O catálogo: pesquisa, instalação, atualização, desativação e desinstalação das extensões referenciadas.

Install Missing Custom Nodes

Analise o workflow aberto e liste as extensões ausentes que explicam os nós vermelhos.

Model Manager

Baixa modelos conhecidos diretamente na subpasta correta de models.

Update All

Atualiza todas as extensões instaladas de uma só vez. É prático, mas também é o comando que mais costuma quebrar uma instalação que estava funcionando.

Snapshot Manager

Salva o estado da instalação (versão do ComfyUI, extensões, pacotes Python) para poder voltar a ele.

#Pré-requisito: saber onde fica a sua pasta custom_nodes

O Manager, como toda extensão, fica na pasta custom_nodes. Sua localização depende de como você instalou o ComfyUI, e metade dos problemas de “nó instalado, mas ausente” vem de uma extensão colocada na pasta errada ou de dependências instaladas no Python errado.

ComfyUI Desktop

A pasta base é aquela que você escolheu durante a instalação (geralmente uma pasta ComfyUI em seus Documentos). Ela contém custom_nodes, models, input e output. O ambiente Python é gerenciado pelo aplicativo, em uma pasta .venv ao lado.

Versão portátil para Windows

No arquivo descompactado: ComfyUI_windows_portable/ComfyUI/custom_nodes. O Python dedicado é ComfyUI_windows_portable/python_embeded, e é ele que deve ser usado para instalar dependências, nunca o Python do sistema.

Instalação manual (git clone)

ComfyUI/custom_nodes, com o ambiente virtual que você criou para o ComfyUI. Ative-o antes de qualquer comando pip.

Em todos os casos

O Git deve estar instalado e acessível: o Manager clona os repositórios com ele. No Windows, verifique com git --version em um terminal.

Se o ComfyUI ainda não estiver instalado, comece pelo guia de instalação do ComfyUI, que compara as instalações Desktop, portátil e manual. Este guia pressupõe uma instalação que já gera uma imagem.

#Instalar o ComfyUI Manager de acordo com sua versão

Existem três situações, e a primeira é a mais frequente em 2026: o Manager já está instalado. Primeiro, verifique se há um botão Manager na barra superior da interface antes de instalar qualquer coisa.

#Caso 1: já está incluído (Desktop, comfy-cli)

O aplicativo ComfyUI Desktop inclui o Manager. O mesmo vale para uma instalação feita com a ferramenta de linha de comando comfy-cli, que o adiciona por padrão. Se o botão Manager aparecer no topo da interface, você não precisa fazer nada: passe à seção seguinte.

#Caso 2: ComfyUI recente, Manager integrado, mas desativado

O repositório principal do ComfyUI agora integra o Manager como uma dependência opcional. Ele não é ativado sozinho: é preciso instalar o arquivo manager_requirements.txt presente na raiz do ComfyUI e depois iniciar o servidor com a opção --enable-manager. Esse é o caminho preferencial para uma instalação manual recente, pois o Manager acompanha então a versão esperada pelo seu ComfyUI.

cd ComfyUI
pip install -r manager_requirements.txt
python main.py --enable-manager

Para não redigitar a opção toda vez, adicione-a ao seu script de inicialização ou ao seu serviço. Na versão portátil, ela fica no final da linha de comando do arquivo run_nvidia_gpu.bat (ou de seu equivalente AMD ou Intel).

#Caso 3: instalação clássica em custom_nodes

Este é o método histórico, ainda documentado no repositório do Manager, e o único possível em uma versão do ComfyUI que não tem o arquivo manager_requirements.txt. Clonamos o repositório em custom_nodes e depois reiniciamos o ComfyUI completamente.

cd ComfyUI/custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
# puis arrêter ComfyUI (Ctrl+C) et le relancer
cd ..
python main.py

cd ComfyUI\custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
cd ..\..
.\python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt
# puis relancer run_nvidia_gpu.bat

Ao reiniciar, leia o terminal. Uma linha mencionando ComfyUI-Manager seguida do número da versão confirma o carregamento. Se, em vez disso, você vir IMPORT FAILED ao lado do nome, as dependências não foram instaladas no Python correto: repita o comando pip com o ambiente do ComfyUI.

#Adicionar um custom node com o Manager

1. 01
   Abrir o catálogo

   Clique em Manager na barra superior e depois em Custom Nodes Manager. A primeira abertura baixa a lista das extensões catalogadas, o que pode levar alguns segundos.
2. 02
   Procurar a extensão

   Digite o nome dele ou uma palavra-chave no campo de pesquisa. As colunas indicam o autor, a descrição, o número de estrelas no GitHub e, dependendo das versões, a data da última atualização. Verifique se o autor realmente corresponde ao repositório que foi recomendado a você: nomes semelhantes são comuns.
3. 03
   Instalar

   Clique em Install. O Manager clona o repositório em custom_nodes e instala as dependências listadas no requirements.txt dele. O terminal rola durante a operação. Se a extensão existir no Comfy Registry, o Manager geralmente oferece uma versão publicada e numerada, em vez da revisão Git mais recente: escolha a versão publicada, que é mais estável.
4. 04
   Reiniciar

   Um banner solicita que você reinicie. Aceite. O ComfyUI reinicia, recarrega todas as extensões e o navegador se reconecta. Atualize a página se a interface não voltar sozinha.
5. 05
   Verificar

   Clique duas vezes na tela e digite o nome de um node da extensão. Se ele aparecer na lista, está concluído. Caso contrário, leia a seção sobre nodes instalados, mas ausentes.

Para scripts e instalações sem interface, o comfy-cli atende à mesma necessidade pela linha de comando: comfy node install seguido do nome da extensão a instala na instalação ativa do ComfyUI. O Manager e o comfy-cli leem a mesma pasta custom_nodes; você pode combinar os dois.

#Nós ausentes: o workflow abre com nós vermelhos

Este é o principal caso de uso do Manager. Você carrega um workflow encontrado online ou extraído de uma imagem, e o ComfyUI exibe uma janela listando os tipos de nós ausentes, com blocos vermelhos no canvas. O workflow usa extensões que você não tem.

1. 01
   Ler a lista de tipos ausentes

   A janela de aviso informa os nomes internos dos nós. Anote-os: eles ajudam a encontrar a extensão se a detecção automática falhar.
2. 02
   Executar Install Missing Custom Nodes

   No menu Manager, este botão cruza os nós ausentes com o banco de extensões conhecidas e exibe aquelas que os fornecem. Marque-as e instale.
3. 03
   Reiniciar e recarregar o workflow

   Após reiniciar, reabra o arquivo do workflow (ou arraste a imagem novamente). Os nós vermelhos devem ter recuperado a cor normal.
4. 04
   Processar as sobras manualmente

   Se um nó continuar ausente, a detecção não encontrou sua extensão: ela não está referenciada, mudou de nome ou o nó foi renomeado pelo autor. Procure o nome interno do nó no repositório ou no fórum de onde veio o workflow e instale a extensão pelo nome no catálogo.

Duas armadilhas aparecem com frequência. A primeira: um workflow que exige uma extensão encontrada em nenhum outro lugar além de um link de download direto. Trate isso com desconfiança; esse é o padrão dos nodes maliciosos descritos mais abaixo. A segunda: um node ausente que, na verdade, pertence ao próprio ComfyUI, porque sua versão é antiga demais. Nesse caso, a solução é atualizar o ComfyUI, não instalar nada.

#Node instalado, mas ausente: IMPORT FAILED, desativado ou na pasta errada

A extensão aparece como instalada no Manager, mas seus nós não existem na interface. O diagnóstico é feito no terminal durante a inicialização do ComfyUI: cada extensão é listada com seu tempo de carregamento, e as que falham exibem a indicação IMPORT FAILED seguida de um traceback do Python. Esse traceback é a única informação útil; copie-o antes de procurar ajuda.

IMPORT FAILED com ModuleNotFoundError

Está faltando uma dependência Python. No Custom Nodes Manager, filtre por Import Failed e clique em Try fix: o Manager reinstala as dependências da extensão. Se isso falhar, instale manualmente o requirements.txt da extensão, usando o Python do ComfyUI (python_embeded na versão portátil).

IMPORT FAILED com um erro de versão

A extensão exige uma versão de um pacote (geralmente torch, numpy, transformers) incompatível com outra extensão ou com o ComfyUI. É preciso decidir: ler as issues do repositório, desativar a extensão menos útil ou esperar uma correção. Não force uma versão do torch, pois você quebraria o ComfyUI.

Extensão desativada

O Manager desativa uma extensão adicionando o sufixo .disabled ao nome da pasta. O ComfyUI então a ignora completamente. Filtre por Disabled no catálogo para reativá-la ou remova o sufixo manualmente.

Pasta errada

Você tem duas instalações (Desktop e portátil, ou dois clones), e a extensão está no custom_nodes da outra. O caminho exato da pasta carregada aparece nas primeiras linhas do terminal durante a inicialização.

Repositório vazio ou truncado

Um clone interrompido deixa uma pasta sem código. Exclua a pasta da extensão e reinstale-a.

Quando o próprio ComfyUI deixa de iniciar ou a interface fica instável após uma instalação, a documentação oficial de solução de problemas recomenda isolar o culpado por dicotomia. Primeiro, inicie o ComfyUI sem nenhuma extensão para confirmar que o problema realmente vem de um custom node.

python main.py --disable-all-custom-nodes

Se tudo funcionar assim, mova metade das pastas de custom_nodes para uma pasta separada, reinicie e repita com a metade restante até isolar a extensão com problema. Com dez extensões, quatro reinicializações são suficientes. Em seguida, desinstale-a pelo Manager e relate o problema no repositório dela, incluindo o registro do terminal.

#Erros de registro: a lista de nodes não é carregada

O Manager não armazena o catálogo localmente: ao ser aberto, baixa uma lista de extensões do repositório do Manager e, para as extensões publicadas, consulta o Comfy Registry, o repositório oficial da Comfy Org onde os autores publicam versões numeradas. Quando essa recuperação falha, o catálogo permanece vazio, a instalação de um node não termina ou uma mensagem indica uma falha ao carregar a lista.

Sem acesso à rede a partir do servidor

O Manager baixa a partir da máquina que executa o ComfyUI, não do seu navegador. Em um servidor remoto ou contêiner, verifique se ele tem acesso à Internet (proxy, firewall, DNS). Um teste com curl para github.com a partir dessa máquina elimina a dúvida.

Modo de banco de dados

Na janela do Manager, um seletor DB permite mudar do canal remoto para uma cópia local da lista. O modo local permite continuar trabalhando com as extensões já conhecidas quando o GitHub está inacessível; ele não verá as extensões adicionadas desde então.

Canal

O Manager oferece vários canais de listas (default, recent, legacy, dev, entre outros). Se uma extensão não aparecer, volte ao canal default antes de procurar mais; os outros canais servem para extensões antigas ou experimentais.

Limites da API do GitHub

Após muitas requisições, o GitHub pode recusar temporariamente chamadas anônimas. Espere alguns minutos em vez de tentar novamente em loop.

Ação recusada pelo nível de segurança

Se o Manager responder que uma ação não é permitida com o nível de segurança atual, isso não é um erro de rede: leia a seção seguinte.

Último recurso, ainda válido: a instalação manual com git clone em custom_nodes, seguida de requirements.txt e de uma reinicialização. Depois, o Manager reconhece a extensão como instalada e saberá atualizá-la.

#Identificar uma extensão arriscada antes de ativá-la

Um custom node é código Python executado na inicialização do ComfyUI, com os direitos do usuário que inicia o servidor: ele pode ler seus arquivos, os tokens de sessão do navegador, suas carteiras e acessar a Internet. Isso não é teórico. Em janeiro de 2026, o repositório oficial do ComfyUI documentou uma série de nós publicados no Comfy Registry sob o nome « Upscaler_4K », que instalavam um ladrão de dados direcionado a navegadores, carteiras de criptomoedas e tokens do Discord. Em abril de 2026, uma campanha descrita pela Censys visava instâncias do ComfyUI expostas na Internet, explorando custom nodes que executam código sem autenticação.

O Manager inclui uma proteção: um nível de segurança, definido pela chave security_level do arquivo config.ini. O repositório do Manager documenta quatro valores: strong, normal (valor padrão), normal- e weak. O nível padrão bloqueia as ações mais arriscadas, como instalar a partir de uma URL Git arbitrária ou instalar pacotes pip sob demanda, e as restrições ficam mais rígidas quando o ComfyUI é iniciado com --listen em um endereço não local. O nível weak remove todas as barreiras: ative-o apenas pelo tempo de uma operação específica, em uma máquina que não esteja ouvindo na rede, e depois volte para normal. A tabela exata das ações permitidas por nível está no README do Manager, que deve ser considerado a referência em caso de dúvida.

Use o catálogo, não um link

As extensões do catálogo e do Registry são pelo menos identificadas e podem ser removidas em caso de denúncia. Um link de download direto ou um repositório sem histórico não é.

Verificar o autor, o histórico e as estrelas

Um repositório criado na semana passada, com dois commits, nenhuma issue e um nome que imita uma extensão conhecida é o perfil típico de um nó malicioso. As estrelas, sozinhas, não provam nada, mas uma extensão realmente usada tem estrelas e issues abertas.

Desconfie das promessas

Upscaler milagroso, modelo comercial «desbloqueado», workflow que exige uma única extensão não encontrada em nenhum outro lugar: recuse por padrão.

Ler o requirements.txt

Antes de instalar uma extensão desconhecida, abra o repositório e leia a lista de dependências. Pacotes sem relação com imagens (acesso ao navegador, rede de baixo nível, compressão de arquivos exóticos) são um sinal de alerta.

Nunca exponha o ComfyUI sem proteção

Sem --listen, o ComfyUI escuta apenas em 127.0.0.1. Se você precisar abri-lo na rede, coloque um proxy reverso com senha ou uma VPN na frente e mantenha security_level como normal.

#Atualizar sem quebrar tudo

A atualização é a segunda maior fonte de falhas depois da instalação. O ComfyUI evolui rapidamente, as extensões ficam para trás e o Update All aplica tudo de uma vez. Três hábitos evitam perder uma manhã.

1. 01
   Criar um instantâneo antes

   Snapshot Manager e depois Save snapshot. O Manager registra a revisão do ComfyUI, a de cada extensão e a lista de pacotes Python na pasta snapshots. Se a atualização quebrar um workflow, Restore devolve tudo a esse estado após a reinicialização.
2. 02
   Atualizar uma extensão por vez

   No catálogo, filtre por Update e atualize primeiro a extensão de que você precisa. Teste o workflow correspondente. Update All continua sendo útil em uma instalação simples, mas depois de um snapshot.
3. 03
   Atualizar o ComfyUI separadamente

   O botão Update ComfyUI atualiza o núcleo. Faça isso quando uma extensão exigir, não por reflexo: cada atualização do núcleo pode quebrar extensões sem manutenção; o próprio README do ComfyUI alerta que os commits mais recentes podem quebrar muitas delas.

No ComfyUI Desktop, o núcleo é atualizado pelo aplicativo e acompanha a versão estável; o Manager serve apenas para as extensões. Na versão portátil e na instalação manual, que acompanham os commits mais recentes, o snapshot é sua única rede de segurança. Um workflow que funciona vale mais do que uma versão mais recente.

#Para se aprofundar

O Manager resolve problemas de extensões; ele não substitui a compreensão do grafo. Os guias a seguir cobrem o restante da cadeia, desde a instalação do ComfyUI até os usos que exigem custom nodes.

• ComfyUI: instalação e primeiros passos localmente
• ControlNet: componha suas imagens, o uso típico dos custom nodes
• Gerar imagens localmente: panorama das ferramentas
• Fooocus: a alternativa sem nós nem extensões

Fontes oficiais consultadas para este guia: a página do Manager e a página de instalação dos custom nodes na documentação do ComfyUI, a página de solução de problemas dos custom nodes, bem como o README do repositório ComfyUI-Manager para os níveis de segurança. Os rótulos dos menus citados correspondem à interface do Manager conforme descrita nessas páginas; eles podem variar de uma versão para outra.

• Documentação do ComfyUI: a interface do Manager
• Documentação do ComfyUI: instalar um custom node
• Documentação do ComfyUI: solucionar problemas dos custom nodes
• Repositório ComfyUI-Manager (README, níveis de segurança)