CommunityBildgithub.com

comfyui-auto-upscale

Skaliert automatisch Bilder hoch, die von ComfyUI generiert werden, über die ComfyUI HTTP/WebSocket-API. Nutzen Sie dieses Skill, wenn der Benutzer die neuesten ComfyUI-Bilder auf Anfrage hochskalieren, einen Ordner mit generierten Bildern stapelweise hochskalieren oder einen Hintergrund-Watcher starten möchte, der jedes neue Bild automatisch hochskaliert, sobald ComfyUI es fertig generiert hat. Unterstützt sowohl integrierte Upscale-Modelle (z.B. 4x-UltraSharp, RealESRGAN) als auch benutzerdefinierte ComfyUI-API-Workflows (z.B. Ultimate SD Upscale, Tiled Diffusion, SUPIR).

Was ist comfyui-auto-upscale?

Dieses Skill ermöglicht die automatische Hochskalierung von Bildern, die mit ComfyUI generiert wurden. Es bietet drei Hauptfunktionen: On-Demand-Hochskalierung der neuesten generierten Bilder, Batch-Hochskalierung eines gesamten Ordners und einen Hintergrund-Watcher, der neue Bilder automatisch hochskaliert, sobald sie von ComfyUI generiert werden. Unterstützt werden sowohl integrierte Upscale-Modelle (wie 4x-UltraSharp oder RealESRGAN) als auch benutzerdefinierte ComfyUI-Workflows im API-Format (z.B. Ultimate SD Upscale, Tiled Diffusion). Das Skill enthält wichtige Sicherheitsmechanismen: eine Endlos-Schleifen-Prävention, die erkennt, ob ein Bild bereits hochskaliert wurde, einen OOM-Guard, der Bilder mit zu großen Abmessungen überspringt, und eine Startprobe, die verhindert, dass der Watcher alte Bilder erneut verarbeitet. Die Konfiguration erfolgt über Kommandozeilen-Flags oder eine wiederverwendbare JSON-Konfigurationsdatei.

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

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

ComfyUI Auto-Upscale

Skaliert Bilder automatisch hoch, nachdem ComfyUI sie generiert hat, und verwendet dabei reine Stdlib-Python-Skripte mit integrierter Endlos-Schleifen-Prävention und Auflösungs-Guards.

Voraussetzungen & Pre-Flight-Check

Überprüfen Sie immer zuerst die ComfyUI-Konnektivität und entdecken Sie installierte Upscale-Modelle:

python scripts/upscale_image.py --check --server http://127.0.0.1:8188
  • Wenn ComfyUI auf einem anderen Host oder Port läuft, übergeben Sie --server http://<host>:<port>.
  • Notieren Sie die installierten Modelle, die unter Installed upscale models zurückgegeben werden. Wenn der Benutzer kein Modell angibt, wählen die Skripte automatisch das beste installierte Modell aus (bevorzugt 4x-UltraSharp.pth, RealESRGAN_x4plus.pth usw.).
  • Wenn die Liste leer ist und der Benutzer eine integrierte Modell-Hochskalierung wünscht, weisen Sie ihn an, ein .pth/.safetensors-Upscale-Modell in ComfyUI/models/upscale_models/ zu platzieren (oder einen benutzerdefinierten --workflow bereitzustellen).

Modus 1: On-Demand-Hochskalierung

Verwenden Sie upscale_image.py, wenn der Benutzer bereits generierte Bilder sofort hochskalieren möchte.

Neueste generierte Bilder aus der ComfyUI-Historie hochskalieren

# Das einzelne neueste nicht hochskalierte Bild hochskalieren
python scripts/upscale_image.py --latest

# Die neuesten 4 generierten Bilder hochskalieren, 4x-Ausgabe um 0,5 verkleinern für ein knackiges 2x-Ergebnis
python scripts/upscale_image.py --latest 4 --scale-by 0.5

# Ein bestimmtes installiertes Modell verwenden und auch eine lokale Kopie speichern
python scripts/upscale_image.py --latest 1 --model 4x-UltraSharp.pth --save-dir ./upscaled_out

Bestimmte lokale Bilder oder einen Ordner hochskalieren

# Einzelne oder mehrere Dateien
python scripts/upscale_image.py --image path/to/gen_0001.png

# Batch-Hochskalierung aller nicht hochskalierten Bilder in einem Verzeichnis
python scripts/upscale_image.py --dir path/to/ComfyUI/output

Vorschau vor der Ausführung (Validierung)

Verwenden Sie --dry-run (und optional --json für strukturierte Ausgabe), um Zielbilder, Abmessungen und Modellauswahl zu überprüfen, ohne etwas in ComfyUI in die Warteschlange zu stellen:

python scripts/upscale_image.py --latest --dry-run --json

Modus 2: Automatischer Post-Generierungs-Watcher

Verwenden Sie watch_upscale.py, um einen Hintergrund-Daemon zu starten, der jedes neue Bild automatisch hochskaliert, sobald ComfyUI es fertig generiert hat.

Wenn Sie den Watcher über run_command starten, setzen Sie IsDaemon: true, damit er im Hintergrund weiterläuft, während der Benutzer Bilder in ComfyUI generiert.

Option A: ComfyUI-API überwachen (Empfohlen – funktioniert lokal und remote)

# Verwendet automatisch WebSocket, wenn websocket-client installiert ist, andernfalls Rückgriff auf leichtgewichtiges /history-Polling
python scripts/watch_upscale.py --mode comfyui --server http://127.0.0.1:8188

# Reines Stdlib-HTTP-Polling alle 1,5 s mit einem benutzerdefinierten Präfix und 2x-Zielausgabe erzwingen
python scripts/watch_upscale.py --mode comfyui --transport poll --interval 1.5 --scale-by 0.5 --prefix "upscaled/{stem}_hd"

Option B: Ein lokales Ausgabeverzeichnis überwachen

python scripts/watch_upscale.py --mode folder --watch-dir "D:/ComfyUI/output" --server http://127.0.0.1:8188

Wiederverwendbare Konfiguration

Kopieren Sie config.example.json in eine lokale Konfigurationsdatei (z.B. my_upscale_config.json) und übergeben Sie --config my_upscale_config.json an eines der Skripte. CLI-Flags überschreiben immer die Werte der Konfigurationsdatei.

Benutzerdefinierte Workflows (Ultimate SD Upscale, Tiled Diffusion, SUPIR usw.)

Um einen benutzerdefinierten ComfyUI-Upscale-/Hires-Fix-Workflow anstelle des integrierten Modell-Upscalers zu verwenden:

python scripts/watch_upscale.py --workflow path/to/upscale_api.json --input-node-id 1

Siehe references/custom-workflows.md zum Exportieren von API-Format-JSON, Umgang mit mehreren LoadImage-Knoten und Fehlerbehebung.

Integrierte Sicherheitsmechanismen

  1. Endlos-Schleifen-Prävention:
    • Jeder eingereichte Upscale-Job wird mit extra_data.auto_upscale_generated = true getaggt und über die prompt_id verfolgt.
    • Ausgaben werden unter upscaled/ gespeichert (filename_prefix = "upscaled/upscaled" standardmäßig) und beide Skripte ignorieren automatisch Bilder in upscaled/ oder solche, die auf upscaled_ enden.
  2. OOM / Über-Upscale-Guard:
    • Bilder, deren längste Seite --max-input-side (Standard 2048 px) überschreitet, werden automatisch übersprungen. Übergeben Sie --max-input-side 0, um dies zu deaktivieren.
  3. Keine rückwirkende Flut beim Watcher-Start:
    • watch_upscale.py erstellt beim Start eine Momentaufnahme der vorhandenen ComfyUI-Historie/Ordnerinhalte und verarbeitet nur neue Bilder, die danach generiert werden.

Überprüfung

  • Bei On-Demand-Läufen bestätigen Sie, dass der Befehl mit Exit-Code 0 beendet wird und [UPSCALED] <source> -> upscaled/... ausgibt.
  • Bei Watcher-Läufen führen Sie einen schnellen --once --dry-run-Test durch oder überprüfen Sie das Daemon-Protokoll auf Waiting for new images... und stellen Sie sicher, dass das Generieren eines Bildes in ComfyUI genau einen [Upscaled OK]-Eintrag auslöst, ohne erneutes Auslösen.

Verwandte Skills