CommunityImagemgithub.com

Configuração do ComfyUI

Instalação local do ComfyUI, gerenciamento de modelos, workflows e solução de problemas para geração de imagem/vídeo/3D com IA no Windows com RTX 3090.

O que é Configuração do ComfyUI?

Esta habilidade descreve a configuração completa de uma instalação local do ComfyUI para geração de imagem, vídeo e 3D com IA em uma máquina Windows 10 Pro equipada com uma RTX 3090 de 24 GB. Ela cobre a estrutura de pastas, gerenciamento de modelos (checkpoints SDXL, UNETs, VAEs, LoRAs, ControlNet, etc.), critical rules para evitar erros comuns (como a necessidade de atualizar tanto `widgets_values` quanto `widgets_values_named` ao alterar nomes de modelos), e procedimentos detalhados para instalação de novos modelos. Além disso, a documentação fornece comandos de inicialização para uso normal e para modelos de vídeo (MiniMax H3), uma tabela de referência rápida com os principais modelos e suas configurações, e uma seção de solução de problemas para falhas frequentes. O objetivo é servir como um guia completo e de referência rápida para desenvolvedores e agentes de IA que precisam gerenciar e operar esta estação de trabalho de geração de conteúdo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/konqiDAM/void-skills/tree/main/comfyui-setup

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Configuração do ComfyUI — Geração de IA Local

Máquina

  • Windows 10 Pro, RTX 3090 24 GB (Ampere), 28 GB RAM (→40 GB), Xeon E5-2696 v4
  • Drives: C: (SO, 35 GB livres), D: SSD 207 GB, E: HDD 9.3 TB
  • ComfyUI 0.44.0 portátil (CUDA 13, Python 3.13) em D:\AI\ComfyUI
  • Servidor: http://127.0.0.1:8188

Estrutura de pastas

  • D:\AI\ComfyUI — app + python_embeded
  • D:\AI\models\ — todos os modelos (via extra_model_paths.yaml)
  • D:\AI\workflows\ — pastas 2d/, 3d/, video/ com JSONs de workflow
  • D:\AI\outputs\staging\<projeto>\ — staging por projeto
  • D:\AI\cache\ — downloads do HF/Torch (HF_HOME, TORCH_HOME)
  • D:\AI\README.txt, SETUP_DOCUMENTATION.md, HANDOFF.md, PROJECTS.md

Pastas de modelos

TipoPastaCarregador
Checkpoint SDXLD:\AI\models\checkpoints\CheckpointLoaderSimple
Modelo de difusão (UNET)D:\AI\models\diffusion_models\UNETLoader
Codificador de textoD:\AI\models\text_encoders\CLIPLoader
VAED:\AI\models\vae\VAELoader
ControlNet/patchD:\AI\models\model_patches\ModelPatchLoader
LoRAD:\AI\models\loras\LoraLoader
CLIP visionD:\AI\models\clip_vision\CLIPVisionLoader
UpscaleD:\AI\models\upscale_models\UpscaleModelLoader
Remoção de fundoD:\AI\models\background_removal\LoadBackgroundRemovalModel
3DD:\AI\models\diffusion_models\ + vae\Nós nativos 3D

Regras críticas

  1. Tanto widgets_values QUANTO widgets_values_named devem ser atualizados ao alterar nomes de modelos em um workflow. O ComfyUI 0.44.0 usa widgets_values_named para os valores reais.
  2. Reinicie o ComfyUI após adicionar modelos (lista de modelos é armazenada em cache na inicialização).
  3. Cache do navegador: Se aparecer "modelo ausente", recarregue a página (F5) e reabra o workflow.
  4. Compilações int8/FP8 são necessárias para 28 GB de RAM. BF16 precisa de 40 GB.
  5. H3 requer: as flags --disable-pinned-memory --fp16-intermediates.
  6. Não misture tipos de modelo. Z-Image usa UNET/CLIP/VAE (separados). Checkpoints SDXL usam CheckpointLoaderSimple.
  7. extra_model_paths.yaml usa barras normais: D:/AI/models/.
  8. Cache do HF/Torch deve estar em D: (definido no bat de inicialização).
  9. Nós MarkdownNote podem referenciar nomes de modelos no texto; limpe-os para evitar falsos avisos de "modelo ausente".

Instalar um novo modelo

  1. Baixe para D:\AI\downloads\ via curl.
  2. Mova para a pasta correta em D:\AI\models\.
  3. Verifique o cabeçalho safetensors:
    D:\AI\ComfyUI\python_embeded\python.exe -c "import struct,json,sys; sys.stdout.reconfigure(encoding='utf-8'); f=open(r'<caminho>','rb'); n=struct.unpack('<Q',f.read(8))[0]; h=json.loads(f.read(n)); print('OK', len(h), 'tensors')"
    
  4. Reinicie o ComfyUI.
  5. Verifique se o carregador o enxerga via http://127.0.0.1:8188/object_info/<LoaderNode>.
  6. Crie o workflow a partir de um template existente, atualize tanto widgets_values quanto widgets_values_named.
  7. Teste via API (veja test_zimage.py para o padrão).
  8. Atualize o README e a documentação.

Comandos de inicialização

:: Normal (imagens, 3D, geral)
D:\AI\ComfyUI\run_nvidia_gpu.bat
:: --enable-manager

:: Vídeo (MiniMax H3)
D:\AI\ComfyUI\run_nvidia_gpu_video.bat
:: --enable-manager --disable-pinned-memory --fp16-intermediates

Principais modelos e configurações

ModeloArquivosConfigurações
Z-Image TurboUNET int8 + codificador FP8 + ae.safetensors8-9 passos, CFG 1.0, res_multistep, simple, 1024-1344px
Nova Anime XL v19NovaAnimeILV190.safetensors (SDXL)28 passos, CFG 5, euler_ancestral, normal, CLIP skip 2
Prefect Pony XL v6PrefectPonyXLV6.safetensors (Pony/SDXL)28 passos, CFG 6, euler_ancestral, normal, CLIP skip 2
Pixal3D/TRELLIS.2UNETs int8 + VAEs + DINOv3 + BiRefNet + MoGe1024px, booleano: desligado=Pixal3D, ligado=TRELLIS.2
MiniMax H3int8 podado + codificador NVFP4 + VAEs de vídeo/áudio5s 864x480, LoRA turbo de 4 passos; 15s 1344x768 ~23 min

Problemas comuns

ProblemaCorreção
hostbuf_file_reader_read failed--disable-dynamic-vram ou use compilações int8/FP8
Fault failed: 2 (H3)--disable-pinned-memory --fp16-intermediates + reduza a resolução
Tela preta (TDR)Reduza resolução/passos; aumente o atraso do TDR no registro
Diálogo "Modelo ausente"Corrija ambos os campos widgets; reinicie o ComfyUI; recarregue a página
Modelo não aparece no menu suspensoReinicie o ComfyUI (lista de modelos é armazenada em cache na inicialização)
H3 I2V falhaFL2VA não instalado; use o workflow seguro R2V

Arquivos de documentação

  • D:\AI\README.txt — referência rápida do usuário
  • D:\AI\SETUP_DOCUMENTATION.md — referência completa de 13 seções
  • D:\AI\HANDOFF.md — referência rápida do agente (procedimentos de instalação)
  • D:\AI\PROJECTS.md — rastreador de projetos
  • D:\AI\projects\<slug>\README.md — docs por projeto

Não instalado (disponível mediante solicitação)

SDXL base, FLUX, LoRAs de pixel-art, ControlNet SDXL, H3 FL2VA, modelos de upscale (ESRGAN/SeedVR2), LoRAs de textura, ferramentas de treinamento Kohya, Krita AI Diffusion, Aseprite/Pixelorama.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas