CommunityImagemgithub.com

comfyui-auto-upscale

Faz o upscale automático de imagens geradas pelo ComfyUI via API HTTP/WebSocket. Use esta skill para upscale sob demanda, em lote ou com um observador automático.

O que é comfyui-auto-upscale?

Esta skill permite o upscale automático de imagens geradas pelo ComfyUI, suportando três modos principais: upscale sob demanda da imagem mais recente ou de imagens específicas, upscale em lote de pastas inteiras e um modo observador (watcher) que monitora o ComfyUI e faz upscale de cada nova imagem automaticamente assim que é gerada. É útil para quem precisa de imagens em alta resolução sem interação manual repetitiva. A skill suporta tanto modelos de upscale embutidos (como 4x-UltraSharp e RealESRGAN, que devem estar na pasta 'upscale_models' do ComfyUI) quanto workflows personalizados no formato JSON da API do ComfyUI (como Ultimate SD Upscale, Tiled Diffusion ou SUPIR). A implementação usa scripts Python puros (stdlib) com prevenção de loop infinito e guardas de resolução para evitar OOM (out-of-memory). Para o modo observador, é possível usar WebSocket (se a biblioteca websocket-client estiver instalada) ou polling HTTP leve sobre a API /history do ComfyUI.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/HomlesRichard/comfyui-auto-upscale/tree/HEAD

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

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/.safetensors em ComfyUI/models/upscale_models/ (ou fornecer um --workflow personalizado).

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, defina IsDaemon: true para 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

  1. Prevenção de Loop Infinito:
    • Cada job de upscale enviado é marcado com extra_data.auto_upscale_generated = true e rastreado pelo prompt_id.
    • As saídas são salvas em upscaled/ (filename_prefix = "upscaled/upscaled" por padrão) e ambos os scripts ignoram automaticamente imagens em upscaled/ ou que correspondam ao prefixo upscaled_.
  2. Guarda contra OOM / Super-upscale:
    • Imagens cujo lado maior exceda --max-input-side (padrão 2048 px) são ignoradas automaticamente. Use --max-input-side 0 para desabilitar.
  3. Sem inundação retroativa na inicialização do observador:
    • watch_upscale.py captura 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 0 e imprime [UPSCALED] <origem> -> upscaled/....
  • Para execuções do observador, execute um teste rápido --once --dry-run ou 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.

Habilidades Relacionadas