Community이미지github.com

comfyui-auto-upscale

ComfyUI에서 생성된 이미지를 자동으로 업스케일합니다. 최신 이미지 업스케일, 폴더 배치 업스케일, 또는 새로운 이미지가 생성될 때마다 자동으로 업스케일하는 백그라운드 감시 모드를 지원합니다.

comfyui-auto-upscale란 무엇인가요?

이 스킬은 ComfyUI HTTP/WebSocket API를 통해 ComfyUI에서 생성된 이미지를 자동으로 업스케일합니다. 사용자가 최신 생성 이미지를 즉시 업스케일하거나, 생성된 이미지 폴더를 배치 업스케일하거나, 새로운 이미지가 생성될 때마다 자동으로 업스케일하는 백그라운드 감시자를 실행할 수 있도록 지원합니다. 기본 제공 업스케일 모델(예: 4x-UltraSharp, RealESRGAN)과 사용자 정의 ComfyUI API 형식 워크플로우(예: Ultimate SD Upscale, Tiled Diffusion, SUPIR)를 모두 지원합니다. 스크립트는 무한 루프 방지 및 해상도 제한과 같은 안전 장치를 내장하고 있어 안정적인 업스케일링을 보장합니다. 이는 AI 에이전트가 텍스트 명령만으로 ComfyUI 출력을 고해상도로 변환하도록 지시하는 데 이상적입니다.

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

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ComfyUI 자동 업스케일

ComfyUI가 이미지 생성을 완료한 후, 순수 표준 라이브러리 파이썬 스크립트를 사용하여 이미지를 자동으로 업스케일합니다. 내장된 무한 루프 방지 및 해상도 보호 기능이 포함되어 있습니다.

필수 조건 및 사전 점검

먼저 항상 ComfyUI 연결 상태를 확인하고 설치된 업스케일 모델을 확인하세요:

python scripts/upscale_image.py --check --server http://127.0.0.1:8188
  • ComfyUI가 다른 호스트나 포트에서 실행 중인 경우 --server http://<host>:<port>를 전달하세요.
  • 설치된 업스케일 모델 아래에 반환된 설치된 모델을 확인하세요. 사용자가 모델을 지정하지 않으면 스크립트는 가장 적합한 설치 모델을 자동 선택합니다(4x-UltraSharp.pth, RealESRGAN_x4plus.pth 등을 선호).
  • 목록이 비어 있고 사용자가 기본 제공 모델 업스케일을 원하는 경우, .pth/.safetensors 업스케일 모델을 ComfyUI/models/upscale_models/에 넣거나 사용자 정의 --workflow를 제공하도록 안내하세요.

모드 1: 요청 시 업스케일링

사용자가 이미 생성된 이미지를 즉시 업스케일하려는 경우 upscale_image.py를 사용하세요.

ComfyUI 기록에서 최신 생성 이미지 업스케일

# 가장 최근의 업스케일되지 않은 단일 이미지 업스케일
python scripts/upscale_image.py --latest

# 최신 생성 이미지 4개를 업스케일하고, 4x 출력을 0.5로 축소하여 선명한 2x 결과 생성
python scripts/upscale_image.py --latest 4 --scale-by 0.5

# 특정 설치 모델을 사용하고 로컬 복사본도 저장
python scripts/upscale_image.py --latest 1 --model 4x-UltraSharp.pth --save-dir ./upscaled_out

특정 로컬 이미지 또는 폴더 업스케일

# 단일 또는 여러 파일
python scripts/upscale_image.py --image path/to/gen_0001.png

# 디렉토리 내 모든 업스케일되지 않은 이미지 배치 업스케일
python scripts/upscale_image.py --dir path/to/ComfyUI/output

실행 전 미리보기 (검증)

--dry-run(및 구조화된 출력을 위해 선택적으로 --json)을 사용하여 대상 이미지, 치수 및 모델 선택을 확인하세요. ComfyUI에 대기열을 추가하지 않습니다:

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

모드 2: 자동 생성 후 감시자

ComfyUI가 이미지 생성을 완료한 직후 모든 새 이미지를 자동으로 업스케일하는 백그라운드 데몬을 실행하려면 watch_upscale.py를 사용하세요.

run_command를 통해 감시자를 시작할 때는 IsDaemon: true로 설정하여 사용자가 ComfyUI에서 이미지를 생성하는 동안 백그라운드에서 계속 실행되도록 하세요.

옵션 A: ComfyUI API 감시 (권장 — 로컬 및 원격 모두 작동)

# websocket-client가 설치된 경우 WebSocket을 자동 사용하고, 그렇지 않으면 가벼운 /history 폴링으로 대체
python scripts/watch_upscale.py --mode comfyui --server http://127.0.0.1:8188

# 순수 표준 라이브러리 HTTP 폴링을 1.5초 간격으로 강제 사용, 사용자 지정 접두사 및 2x 대상 출력
python scripts/watch_upscale.py --mode comfyui --transport poll --interval 1.5 --scale-by 0.5 --prefix "upscaled/{stem}_hd"

옵션 B: 로컬 출력 디렉토리 감시

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

재사용 가능한 구성

config.example.json을 로컬 구성 파일(예: my_upscale_config.json)에 복사하고 --config my_upscale_config.json을 두 스크립트 중 하나에 전달하세요. CLI 플래그는 항상 구성 파일 값을 재정의합니다.

사용자 정의 워크플로우 (Ultimate SD Upscale, Tiled Diffusion, SUPIR 등)

기본 제공 모드 업스케일러 대신 사용자 정의 ComfyUI 업스케일/고해상도 수정 워크플로우를 사용하려면:

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

API 형식 JSON 내보내기, 여러 LoadImage 노드 처리 및 문제 해결에 대해서는 references/custom-workflows.md를 참조하세요.

내장 안전 장치

  1. 무한 루프 방지:
    • 제출된 모든 업스케일 작업은 extra_data.auto_upscale_generated = true로 태그가 지정되고 prompt_id로 추적됩니다.
    • 출력은 upscaled/ 아래에 저장되며(기본적으로 filename_prefix = "upscaled/upscaled"), 두 스크립트 모두 upscaled/ 디렉토리 또는 upscaled_ 접두사와 일치하는 이미지를 자동으로 무시합니다.
  2. OOM / 과도 업스케일 방지:
    • 가장 긴 변이 --max-input-side(기본값 2048 px)를 초과하는 이미지는 자동으로 건너뜁니다. 비활성화하려면 --max-input-side 0을 전달하세요.
  3. 감시자 시작 시 소급 플러드 방지:
    • watch_upscale.py는 시작 시 기존 ComfyUI 기록/폴더 내용을 스냅샷하고 이후에 생성된 새로운 이미지만 처리합니다.

확인

  • 요청 시 실행의 경우, 명령이 종료 코드 0으로 종료되고 [UPSCALED] <source> -> upscaled/...를 출력하는지 확인하세요.
  • 감시자 실행의 경우, 빠른 --once --dry-run 테스트를 실행하거나 데몬 로그에서 Waiting for new images...를 확인하고, ComfyUI에서 하나의 이미지를 생성하면 재트리거 없이 정확히 하나의 [Upscaled OK] 항목이 트리거되는지 확인하세요.

관련 스킬