ComfyUI Auto-Upscale (Auto-Upscale do ComfyUI)
Aumenta automaticamente a resolução (upscale) de imagens após o ComfyUI finalizar a geração, usando scripts Python puramente da stdlib com prevenção de loop infinito e guardas de resolução.
Pré-requisitos e Verificação Pré-voo
Sempre verifique a conectividade com o ComfyUI e descubra os modelos de upscale instalados primeiro:
python scripts/upscale_image.py --check --server http://127.0.0.1:8188
- Se o ComfyUI estiver em outro host ou porta, use
--server http://<host>:<port>. - Anote os modelos instalados retornados em "Installed upscale models". Se o usuário não especificar um modelo, os scripts selecionam automaticamente o melhor modelo instalado (preferindo
4x-UltraSharp.pth,RealESRGAN_x4plus.pth, etc.). - Se a lista estiver vazia e o usuário quiser usar upscale com modelo embutido, instrua-o a colocar um modelo
.pth/.safetensorsemComfyUI/models/upscale_models/(ou fornecer um--workflowpersonalizado).
Modo 1: Upscale Sob Demanda
Use upscale_image.py quando o usuário quiser aumentar a resolução de imagens já geradas imediatamente.
Fazer upscale da(s) imagem(ns) mais recente(s) do histórico do ComfyUI
# Fazer upscale da imagem mais recente que ainda não foi submetida a upscale
python scripts/upscale_image.py --latest
# Fazer upscale das 4 imagens mais recentes, reduzindo a saída 4x por 0.5 para um resultado 2x nítido
python scripts/upscale_image.py --latest 4 --scale-by 0.5
# Usar um modelo instalado específico e também salvar uma cópia local
python scripts/upscale_image.py --latest 1 --model 4x-UltraSharp.pth --save-dir ./upscaled_out
Fazer upscale de imagem(ns) local(is) específica(s) ou de uma pasta
# Arquivo único ou múltiplos
python scripts/upscale_image.py --image caminho/para/gen_0001.png
# Upscale em lote de todas as imagens ainda sem upscale em um diretório
python scripts/upscale_image.py --dir caminho/para/ComfyUI/output
Visualizar antes de executar (Validação)
Use --dry-run (e opcionalmente --json para saída estruturada) para verificar as imagens alvo, dimensões e seleção de modelo sem enfileirar nada no ComfyUI:
python scripts/upscale_image.py --latest --dry-run --json
Modo 2: Observador Automático Pós-Geração
Use watch_upscale.py para executar um daemon em segundo plano que faz upscale automaticamente de cada nova imagem assim que o ComfyUI termina de gerá-la.
Ao iniciar o observador via
run_command, definaIsDaemon: truepara que ele continue em execução em segundo plano enquanto o usuário gera imagens no ComfyUI.
Opção A: Observar a API do ComfyUI (Recomendado — funciona local e remotamente)
# Usa WebSocket automaticamente se websocket-client estiver instalado, caso contrário usa polling HTTP leve em /history
python scripts/watch_upscale.py --mode comfyui --server http://127.0.0.1:8188
# Forçar polling HTTP puro da stdlib a cada 1,5s com um prefixo personalizado e saída 2x alvo
python scripts/watch_upscale.py --mode comfyui --transport poll --interval 1.5 --scale-by 0.5 --prefix "upscaled/{stem}_hd"
Opção B: Observar um Diretório de Saída Local
python scripts/watch_upscale.py --mode folder --watch-dir "D:/ComfyUI/output" --server http://127.0.0.1:8188
Configuração Reutilizável
Copie config.example.json para um arquivo de configuração local (ex.: my_upscale_config.json) e use --config my_upscale_config.json em qualquer um dos scripts. As flags da CLI sempre sobrescrevem os valores do arquivo de configuração.
Workflows Personalizados (Ultimate SD Upscale, Tiled Diffusion, SUPIR, etc.)
Para usar um workflow de upscale/hires-fix personalizado do ComfyUI em vez do escalonador embutido:
python scripts/watch_upscale.py --workflow caminho/para/upscale_api.json --input-node-id 1
Consulte references/custom-workflows.md para exportar JSON no formato da API, lidar com múltiplos nós LoadImage e solução de problemas.
Guardas de Segurança Embutidas
- Prevenção de Loop Infinito:
- Cada job de upscale enviado é marcado com
extra_data.auto_upscale_generated = truee rastreado peloprompt_id. - As saídas são salvas em
upscaled/(filename_prefix = "upscaled/upscaled"por padrão) e ambos os scripts ignoram automaticamente imagens emupscaled/ou que correspondam ao prefixoupscaled_.
- Cada job de upscale enviado é marcado com
- Guarda contra OOM / Super-upscale:
- Imagens cujo lado maior exceda
--max-input-side(padrão2048px) são ignoradas automaticamente. Use--max-input-side 0para desabilitar.
- Imagens cujo lado maior exceda
- Sem inundação retroativa na inicialização do observador:
watch_upscale.pycaptura o histórico/pasta existente do ComfyUI na inicialização e processa apenas as imagens novas geradas depois.
Verificação
- Para execuções sob demanda, confirme que o comando termina com código
0e imprime[UPSCALED] <origem> -> upscaled/.... - Para execuções do observador, execute um teste rápido
--once --dry-runou verifique o log do daemon para "Waiting for new images..." e verifique que gerar uma imagem no ComfyUI dispara exatamente uma entrada[Upscaled OK]sem reativação.