Community이미지github.com

ComfyUI 설정

로컬 ComfyUI 설치, 모델 관리, 워크플로우, 그리고 Windows RTX 3090 환경에서의 AI 이미지/비디오/3D 생성 문제 해결을 위한 안내서입니다.

ComfyUI 설정란 무엇인가요?

이 스킬은 Windows 10 Pro, RTX 3090 24GB, 28GB RAM 환경에서 ComfyUI 0.44.0 포터블 버전을 사용하여 로컬 AI 이미지, 비디오, 3D 생성을 설정하고 관리하는 방법을 설명합니다. ComfyUI는 `D:\AI\ComfyUI`에 설치되며, 모든 모델은 `D:\AI\models` 폴더(extra_model_paths.yaml 통해 연결)에 저장됩니다. 주요 작업으로는 SDXL 체크포인트, UNET, VAE, LoRA, ControlNet 등 다양한 모델 설치 및 관리, 워크플로우 템플릿 생성 및 테스트, MiniMax H3 비디오 모델과 Pixal3D/TRELLIS.2 3D 모델 등 고급 모델 실행이 포함됩니다. 중요한 규칙으로는 워크플로우에서 모델명 변경 시 `widgets_values`와 `widgets_values_named`를 모두 업데이트해야 하며, 모델 추가 후 ComfyUI를 재시작해야 합니다. 메모리 제약을 해결하기 위해 int8/FP8 빌드 사용이 권장되며, H3 모델 실행 시 `--disable-pinned-memory --fp16-intermediates` 플래그가 필요합니다. 이 스킬은 Cursor, Claude Code, Codex 등 모든 AI 에이전트 플랫폼에서 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/konqiDAM/void-skills/tree/main/comfyui-setup

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

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

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

문서

ComfyUI 설정 — 로컬 AI 생성

시스템

  • Windows 10 Pro, RTX 3090 24 GB (Ampere), 28 GB RAM (→40 GB), Xeon E5-2696 v4
  • 드라이브: C: (OS, 35 GB 여유 공간), D: SSD 207 GB, E: HDD 9.3 TB
  • ComfyUI 0.44.0 포터블 (CUDA 13, Python 3.13) 위치: D:\AI\ComfyUI
  • 서버: http://127.0.0.1:8188

폴더 구조

  • D:\AI\ComfyUI — 앱 + python_embeded
  • D:\AI\models\ — 모든 모델 (extra_model_paths.yaml 통해 연결)
  • D:\AI\workflows\ — 2d/, 3d/, video/ 워크플로우 JSON 파일
  • D:\AI\outputs\staging\<project>\ — 프로젝트별 스테이징
  • D:\AI\cache\ — HF/Torch 다운로드 (HF_HOME, TORCH_HOME)
  • D:\AI\README.txt, SETUP_DOCUMENTATION.md, HANDOFF.md, PROJECTS.md

모델 폴더

유형폴더로더
SDXL 체크포인트D:\AI\models\checkpoints\CheckpointLoaderSimple
확산 모델 (UNET)D:\AI\models\diffusion_models\UNETLoader
텍스트 인코더D:\AI\models\text_encoders\CLIPLoader
VAED:\AI\models\vae\VAELoader
ControlNet/패치D:\AI\models\model_patches\ModelPatchLoader
LoRAD:\AI\models\loras\LoraLoader
CLIP 비전D:\AI\models\clip_vision\CLIPVisionLoader
업스케일D:\AI\models\upscale_models\UpscaleModelLoader
배경 제거D:\AI\models\background_removal\LoadBackgroundRemovalModel
3DD:\AI\models\diffusion_models\ + vae\네이티브 3D 노드

중요 규칙

  1. widgets_values와 widgets_values_named 모두 워크플로우에서 모델 이름을 변경할 때 업데이트해야 합니다. ComfyUI 0.44.0은 widgets_values_named를 실제 값으로 사용합니다.
  2. 모델 추가 후 ComfyUI를 재시작하세요 (모델 목록은 시작 시 캐싱됨).
  3. 브라우저 캐시: "모델을 찾을 수 없음" 메시지가 나타나면 페이지를 새로고침(F5)하고 워크플로우를 다시 여세요.
  4. int8/FP8 빌드는 28 GB RAM 환경에서 필요합니다. BF16은 40 GB가 필요합니다.
  5. H3 필요 플래그: --disable-pinned-memory --fp16-intermediates.
  6. 모델 유형을 혼합하지 마세요. Z-Image는 UNET/CLIP/VAE(별도)를 사용합니다. SDXL 체크포인트는 CheckpointLoaderSimple을 사용합니다.
  7. extra_model_paths.yaml은 슬래시를 사용합니다: D:/AI/models/.
  8. HF/Torch 캐시는 D: 드라이브에 있어야 합니다 (launch bat에서 설정).
  9. MarkdownNote 노드는 텍스트에 모델 이름을 참조할 수 있습니다. 잘못된 "모델을 찾을 수 없음" 경고를 방지하려면 정리하세요.

새 모델 설치

  1. D:\AI\downloads\에 curl로 다운로드하세요.
  2. D:\AI\models\ 아래 올바른 폴더로 이동하세요.
  3. safetensors 헤더를 확인하세요:
    D:\AI\ComfyUI\python_embeded\python.exe -c "import struct,json,sys; sys.stdout.reconfigure(encoding='utf-8'); f=open(r'<path>','rb'); n=struct.unpack('<Q',f.read(8))[0]; h=json.loads(f.read(n)); print('OK', len(h), 'tensors')"
    
  4. ComfyUI를 재시작하세요.
  5. http://127.0.0.1:8188/object_info/<LoaderNode>를 통해 로더가 모델을 인식하는지 확인하세요.
  6. 기존 템플릿에서 워크플로우를 생성하고, widgets_values와 widgets_values_named를 모두 업데이트하세요.
  7. API를 통해 테스트하세요 (패턴은 test_zimage.py 참조).
  8. README와 문서를 업데이트하세요.

실행 명령어

:: 일반 (이미지, 3D, 일반)
D:\AI\ComfyUI\run_nvidia_gpu.bat
:: --enable-manager

:: 비디오 (MiniMax H3)
D:\AI\ComfyUI\run_nvidia_gpu_video.bat
:: --enable-manager --disable-pinned-memory --fp16-intermediates

주요 모델 및 설정

모델파일설정
Z-Image Turboint8 UNET + FP8 인코더 + ae.safetensors8-9 단계, CFG 1.0, res_multistep, simple, 1024-1344px
Nova Anime XL v19NovaAnimeILV190.safetensors (SDXL)28 단계, CFG 5, euler_ancestral, normal, CLIP skip 2
Prefect Pony XL v6PrefectPonyXLV6.safetensors (Pony/SDXL)28 단계, CFG 6, euler_ancestral, normal, CLIP skip 2
Pixal3D/TRELLIS.2int8 UNET + VAE + DINOv3 + BiRefNet + MoGe1024px, boolean: off=Pixal3D, on=TRELLIS.2
MiniMax H3pruned int8 + NVFP4 인코더 + 비디오/오디오 VAE5초 864x480, 4단계 turbo LoRA; 15초 1344x768 ~23분

일반적인 문제

문제해결책
hostbuf_file_reader_read failed--disable-dynamic-vram 사용 또는 int8/FP8 빌드 사용
Fault failed: 2 (H3)--disable-pinned-memory --fp16-intermediates + 해상도 낮춤
화면이 검게 변함 (TDR)해상도/단계 수 줄임; 레지스트리에서 TDR 지연 시간 증가
"모델을 찾을 수 없음" 대화상자두 위젯 필드 수정; ComfyUI 재시작; 페이지 새로고침
드롭다운에 모델이 없음ComfyUI 재시작 (모델 목록은 시작 시 캐싱됨)
H3 I2V 실패FL2VA가 설치되지 않음; R2V 안전 워크플로우 사용

문서 파일

  • D:\AI\README.txt — 사용자 빠른 참조
  • D:\AI\SETUP_DOCUMENTATION.md — 전체 13개 섹션 참조
  • D:\AI\HANDOFF.md — 에이전트 빠른 참조 (설치 절차)
  • D:\AI\PROJECTS.md — 프로젝트 추적
  • D:\AI\projects\<slug>\README.md — 프로젝트별 문서

설치되지 않음 (요청 시 사용 가능)

SDXL base, FLUX, 픽셀 아트 LoRA, SDXL ControlNet, H3 FL2VA, 업스케일 모델 (ESRGAN/SeedVR2), 텍스처 LoRA, Kohya 학습 도구, Krita AI Diffusion, Aseprite/Pixelorama.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬