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 modelszurückgegeben werden. Wenn der Benutzer kein Modell angibt, wählen die Skripte automatisch das beste installierte Modell aus (bevorzugt4x-UltraSharp.pth,RealESRGAN_x4plus.pthusw.). - Wenn die Liste leer ist und der Benutzer eine integrierte Modell-Hochskalierung wünscht, weisen Sie ihn an, ein
.pth/.safetensors-Upscale-Modell inComfyUI/models/upscale_models/zu platzieren (oder einen benutzerdefinierten--workflowbereitzustellen).
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_commandstarten, setzen SieIsDaemon: 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
- Endlos-Schleifen-Prävention:
- Jeder eingereichte Upscale-Job wird mit
extra_data.auto_upscale_generated = truegetaggt und über dieprompt_idverfolgt. - Ausgaben werden unter
upscaled/gespeichert (filename_prefix = "upscaled/upscaled"standardmäßig) und beide Skripte ignorieren automatisch Bilder inupscaled/oder solche, die aufupscaled_enden.
- Jeder eingereichte Upscale-Job wird mit
- OOM / Über-Upscale-Guard:
- Bilder, deren längste Seite
--max-input-side(Standard2048px) überschreitet, werden automatisch übersprungen. Übergeben Sie--max-input-side 0, um dies zu deaktivieren.
- Bilder, deren längste Seite
- Keine rückwirkende Flut beim Watcher-Start:
watch_upscale.pyerstellt 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
0beendet 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 aufWaiting 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.