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
| Tipo | Pasta | Carregador |
|---|
| Checkpoint SDXL | D:\AI\models\checkpoints\ | CheckpointLoaderSimple |
| Modelo de difusão (UNET) | D:\AI\models\diffusion_models\ | UNETLoader |
| Codificador de texto | D:\AI\models\text_encoders\ | CLIPLoader |
| VAE | D:\AI\models\vae\ | VAELoader |
| ControlNet/patch | D:\AI\models\model_patches\ | ModelPatchLoader |
| LoRA | D:\AI\models\loras\ | LoraLoader |
| CLIP vision | D:\AI\models\clip_vision\ | CLIPVisionLoader |
| Upscale | D:\AI\models\upscale_models\ | UpscaleModelLoader |
| Remoção de fundo | D:\AI\models\background_removal\ | LoadBackgroundRemovalModel |
| 3D | D:\AI\models\diffusion_models\ + vae\ | Nós nativos 3D |
Regras críticas
- 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.
- Reinicie o ComfyUI após adicionar modelos (lista de modelos é armazenada em cache na inicialização).
- Cache do navegador: Se aparecer "modelo ausente", recarregue a página (F5) e reabra o workflow.
- Compilações int8/FP8 são necessárias para 28 GB de RAM. BF16 precisa de 40 GB.
- H3 requer: as flags
--disable-pinned-memory --fp16-intermediates.
- Não misture tipos de modelo. Z-Image usa UNET/CLIP/VAE (separados). Checkpoints SDXL usam CheckpointLoaderSimple.
- extra_model_paths.yaml usa barras normais:
D:/AI/models/.
- Cache do HF/Torch deve estar em D: (definido no bat de inicialização).
- Nós MarkdownNote podem referenciar nomes de modelos no texto; limpe-os para evitar falsos avisos de "modelo ausente".
Instalar um novo modelo
- Baixe para
D:\AI\downloads\ via curl.
- Mova para a pasta correta em
D:\AI\models\.
- 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')"
- Reinicie o ComfyUI.
- Verifique se o carregador o enxerga via
http://127.0.0.1:8188/object_info/<LoaderNode>.
- Crie o workflow a partir de um template existente, atualize tanto
widgets_values quanto widgets_values_named.
- Teste via API (veja
test_zimage.py para o padrão).
- 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
| Modelo | Arquivos | Configurações |
|---|
| Z-Image Turbo | UNET int8 + codificador FP8 + ae.safetensors | 8-9 passos, CFG 1.0, res_multistep, simple, 1024-1344px |
| Nova Anime XL v19 | NovaAnimeILV190.safetensors (SDXL) | 28 passos, CFG 5, euler_ancestral, normal, CLIP skip 2 |
| Prefect Pony XL v6 | PrefectPonyXLV6.safetensors (Pony/SDXL) | 28 passos, CFG 6, euler_ancestral, normal, CLIP skip 2 |
| Pixal3D/TRELLIS.2 | UNETs int8 + VAEs + DINOv3 + BiRefNet + MoGe | 1024px, booleano: desligado=Pixal3D, ligado=TRELLIS.2 |
| MiniMax H3 | int8 podado + codificador NVFP4 + VAEs de vídeo/áudio | 5s 864x480, LoRA turbo de 4 passos; 15s 1344x768 ~23 min |
Problemas comuns
| Problema | Correçã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 suspenso | Reinicie o ComfyUI (lista de modelos é armazenada em cache na inicialização) |
| H3 I2V falha | FL2VA 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.