# TJ NODE STUDIO ONE (통합 패키지) # TJ NODE STUDIO ONE (Integrated Package) > **ComfyUI 올인원 이미지 생성 UI 패키지** — Z-Image ONE STUDIO, Flux.2 Klein ONE STUDIO, Qwen Image Edit 2511 ONE STUDIO, Krea 2 ONE STUDIO, **SDXL ONE STUDIO** 다섯 가지 노드를 단일 패키지로 제공합니다. > **ComfyUI all-in-one image generation UI package** — Z-Image ONE STUDIO, Flux.2 Klein ONE STUDIO, Qwen Image Edit 2511 ONE STUDIO, Krea 2 ONE STUDIO, **SDXL ONE STUDIO** provides five nodes in a single package. > 워크플로우 배선 없이 노드 하나에서 T2I · I2I · Inpaint · Outpaint · ControlNet · Edit · Faceswap · ANGLE · Upscale(SeedVR2) 등 다양한 모드를 전환합니다. > switch between modes in a single node without workflow wiring T2I · I2I · Inpaint · Outpaint · ControlNet · Edit · Faceswap · ANGLE · Upscale(SeedVR2) etc. switch between various modes. > > 🧪 **SDXL ONE STUDIO는 현재 테스트 버전입니다.** 기능은 동작하지만 일부 옵션이 변경될 수 있습니다. > 🧪 **SDXL ONE STUDIO is currently a test/beta version.** Core features are functional but some options may change. > > ⚠️ **생성 방식**: 모든 노드의 생성은 ComfyUI 상단 **RUN**이 아닌 노드 내부의 **▶ Generate** 버튼으로 실행합니다. RUN 실행 시 마지막으로 생성된 이미지가 OUTPUT image 슬롯으로 출력됩니다. > ⚠️ **Generation Method**: generation for all nodes is executed using at the top of ComfyUI **RUN**instead of, use the button inside the node **▶ Generate** button. When RUN is executed, the most recently generated image is output through the OUTPUT image slot.. --- Screen Shot 2026-06-27 at 05 58 39 907 AM

Screen Shot 2026-06-27 at 05 58 39 907 AM

## 목차 ## Table of Contents 1. [포함 노드](#포함-노드) 1. [Included Nodes](#포함-노드) 2. [설치 방법](#설치-방법) 2. [Installation](#설치-방법) 3. [필수 커스텀 노드](#필수-커스텀-노드) 3. [Required Custom Nodes](#필수-커스텀-노드) 4. [Z-Image ONE STUDIO — 기능 상세](#z-image-one-studio--기능-상세) 4. [Z-Image ONE STUDIO — Feature Details](#z-image-one-studio--기능-상세) 5. [Flux.2 Klein ONE STUDIO — 기능 상세](#flux2-klein-one-studio--기능-상세) 5. [Flux.2 Klein ONE STUDIO — Feature Details](#flux2-klein-one-studio--기능-상세) 6. [Qwen Image Edit 2511 ONE STUDIO — 기능 상세](#qwen-image-edit-2511-one-studio--기능-상세) 6. [Qwen Image Edit 2511 ONE STUDIO — Feature Details](#qwen-image-edit-2511-one-studio--기능-상세) 7. [Krea 2 ONE STUDIO — 기능 상세](#krea-2-one-studio--기능-상세) 7. [Krea 2 ONE STUDIO — Feature Details](#krea-2-one-studio--기능-상세) 8. [SDXL ONE STUDIO — 기능 상세 🧪](#sdxl-one-studio--기능-상세-) 8. [SDXL ONE STUDIO — Feature Details 🧪](#sdxl-one-studio--기능-상세-) 9. [공통 기능](#공통-기능) 8. [Common Features](#공통-기능) 9. [버그 수정 이력](#버그-수정-이력) 9. [Bug Fix History](#버그-수정-이력) 10. [라이선스](#라이선스) 10. [License](#라이선스) --- ## 포함 노드 ## Included Nodes | 노드 이름
_{Node Name}| 대상 모델
_{Target Model}| 지원 모드
_{Supported Modes}| |---|---|---| | **Z-Image ONE STUDIO (TJ)** | Z-Image Turbo (flow-matching) | T2I · I2I · Inpaint · Outpaint · RE-BG · ControlNet · Face Redraw · **Upscale** | | **Flux.2 Klein ONE STUDIO (TJ)** | Flux.2-Klein (9B / 4B) | T2I · I2I · Edit · **Inpaint · Outpaint** · Faceswap · **Upscale** | | **Qwen Image Edit 2511 ONE STUDIO (TJ)** | Qwen2.5-VL 기반 Image Edit 모델
_{Qwen2.5-VL based Image Edit model}| T2I · I2I · Edit(최대 3장) · Inpaint · **Outpaint** · Faceswap · **Angle** · **Upscale**
_{T2I · I2I · Edit(up to 3 images) · Inpaint · **Outpaint** · Faceswap · **Angle** · **Upscale**}| | **Krea 2 ONE STUDIO (TJ)** | Krea.ai 이미지 생성 모델
_{Krea.ai image generation model}| T2I · I2I · **ControlNet(depth/canny 🧪)** · **IDENTITY 🧪** · **Upscale** | | **SDXL ONE STUDIO (TJ)** 🧪 | SDXL Checkpoint / Separate UNET 모델
_{SDXL Checkpoint / Separate UNET model}| T2I · I2I · Inpaint · Outpaint · Upscale *(테스트 버전 / Test Version)* | > **언어 지원**: 모든 노드의 Settings에서 한국어 / English 전환 가능 > **Language Support**: Korean / English can be selected in Settings for every node --- ## 설치 방법 ## Installation ### ComfyUI Manager (권장) ### ComfyUI Manager (recommended) ComfyUI Manager → Install Custom Nodes → `ComfyUI-TJ_NODE_STUDIO_ONE` 검색 후 설치 ComfyUI Manager → Install Custom Nodes → `ComfyUI-TJ_NODE_STUDIO_ONE` search and install ### 수동 설치 ### Manual Installation ```bash cd ComfyUI/custom_nodes git clone https://github.com/designloves2/ComfyUI-TJ_NODE_STUDIO_ONE.git ``` ComfyUI를 재시작하면 Add Node 메뉴에서 모든 노드를 찾을 수 있습니다. ComfyUI After restarting all nodes will be available in the Add Node menu. --- ## 필수 커스텀 노드 ## Required Custom Nodes > **아래 노드들을 수동으로 설치하기 번거롭다면 자동 설치 스크립트를 사용하세요.** > **Use the automatic installation script if installing the nodes below manually is inconvenient..** ### ⚡ 자동 설치 (권장) ### ⚡ Automatic Installation (recommended) 이 패키지 폴더 안에 포함된 스크립트를 실행하면 필수 노드를 한 번에 설치합니다. Run the script included in this package folder to install all required nodes at once.. **Windows:** ``` install_requirements.bat ← 더블클릭으로 실행 ``` **Mac / Linux:** ```bash chmod +x install_requirements.sh ./install_requirements.sh ``` - 이미 설치된 노드는 자동으로 건너뜁니다 - Already installed nodes are skipped automatically - `requirements.txt`가 있는 노드는 pip install까지 자동 처리 - `requirements.txt`Nodes with requirements.txt are automatically processed through pip install - 완료 후 ComfyUI를 재시작하면 모든 노드가 로드됩니다 - Restart ComfyUI after completion to load all nodes ### 수동 설치 목록 ### Manual Installation List | 노드
_Node| 용도
_Purpose| 필수 대상
_{Required For}| |---|---|---| | [ComfyUI-Impact-Pack](https://github.com/ltdrdata/ComfyUI-Impact-Pack) | FaceDetailer — 얼굴 감지·재생성·블렌드 핵심 엔진
_{FaceDetailer — core engine for face detection, regeneration, and blending}| Z-Image Face Redraw | | [ComfyUI-Impact-Subpack](https://github.com/ltdrdata/ComfyUI-Impact-Subpack) | Impact Pack 필수 서브팩 (함께 설치 필요)
_{Impact Pack required subpack (must be installed together)}| Z-Image Face Redraw | | [ComfyUI-KJNodes](https://github.com/kijai/ComfyUI-KJNodes) | FluxKVCache · ImagePadKJ · FluxKontext 관련 노드
_{FluxKVCache · ImagePadKJ · FluxKontext related nodes}| Klein · QE2511 | | [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF) | GGUF 형식 모델 로딩
_{GGUF format model loading}| 선택 (GGUF 사용 시)
_{selection (GGUF when used)}| | [ComfyUI_FaceAnalysis](https://github.com/cubiq/ComfyUI_FaceAnalysis) | Faceswap 모드 얼굴 감지
_{Faceswap mode face detection}| Klein · QE2511 Faceswap | | [ComfyUI-RMBG](https://github.com/1038lab/ComfyUI-RMBG) | 배경 제거
_{background removal}| Z-Image RE-BG | | [comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) | ControlNet 전처리기 (depth/canny)
_{ControlNet preprocessor (depth/canny)}| Z-Image ControlNet · Krea2 ControlNet 🧪 | | [ComfyUI-SeedVR2](https://github.com/numz/ComfyUI-SeedVR2_VideoUpscaler) | SeedVR2 AI 업스케일 노드
_{SeedVR2 AI upscaling node}| 전체 노드 Upscale 모드
_{Upscale mode for all nodes}| | [comfyui-krea2-controlnet](https://github.com/facok/comfyui-krea2-controlnet) 🧪 | Krea2 Control LoRA (depth)
_{Krea2 Control LoRA (depth)}| Krea2 ControlNet Depth | | [comfyui-krea2edit](https://github.com/lbouaraba/comfyui-krea2edit) 🧪 | Krea2 in-context 편집
_{Krea2 in-context edit}| Krea2 IDENTITY | | [ComfyUI-NK2E](https://github.com/Nynxz/ComfyUI-NK2E) 🧪 | Krea2 NK2E in-context (canny)
_{Krea2 NK2E in-context (canny)}| Krea2 ControlNet Canny | --- ## Z-Image ONE STUDIO — 기능 상세 ## Z-Image ONE STUDIO — Feature Details ### 지원 모드 ### Supported Modes | 모드
_Mode| 설명
_Description| |---|---| | **T2I** | 텍스트 → 이미지 기본 생성
_{basic text-to-image generation}| | **I2I** | 소스 이미지 기반 변형 생성
_{source image-based transformation}| | **INPAINT** | 내장 마스크 에디터로 특정 영역만 재생성 (DifferentialDiffusion)
_{regenerate only selected areas using the built-in mask editor (DifferentialDiffusion)}| | **OUTPAINT** | 이미지 캔버스 확장 후 빈 영역 인페인트
_{extend the image canvas and inpaint empty areas}| | **RE-BG** | RMBG로 서브젝트 분리 → 배경 완전 재생성 (경계선 없음)
_{RMBGseparate the subject with RMBG and completely regenerate the background (without boundary artifacts)}| | **CONTROLNET** | Depth / Canny / Pose / HED / MLSD 레퍼런스 가이드 생성
_{Depth / Canny / Pose / HED / MLSD generate a reference guide}| | **FACE REDRAW** | 얼굴 자동 감지 → 크롭 → LoRA 재생성 → 원본에 블렌드
_{automatically detect the face, crop it, regenerate with LoRA, and blend it into the original}| | **UPSCALE** | SeedVR2 AI 업스케일 — DiT 모델 기반 초고해상도 변환
_{SeedVR2 AI — DiT ultra-high-resolution conversion using a DiT model}| ### 필수 모델 ### Required Models | 종류
_Type| 경로
_Path| 다운로드
_Download| |---|---|---| | Diffusion Model | `models/diffusion_models/` | [z_image_turbo_bf16](https://huggingface.co/Comfy-Org/z_image_turbo) | | Text Encoder | `models/text_encoders/` | [qwen_3_4b](https://huggingface.co/Comfy-Org/z_image_turbo) | | VAE | `models/vae/` | [ae.safetensors](https://huggingface.co/Comfy-Org/z_image_turbo) | | ControlNet (선택)
_{ControlNet (selection)}| `models/controlnet/` | [Z-Image-Turbo-Fun-Controlnet-Union](https://huggingface.co/alibaba-pai/Z-Image-Turbo-Fun-Controlnet-Union) | --- ## Flux.2 Klein ONE STUDIO — 기능 상세 ## Flux.2 Klein ONE STUDIO — Feature Details ### 지원 모드 ### Supported Modes | 모드
_Mode| 설명
_Description| |---|---| | **T2I** | 텍스트 → 이미지 기본 생성
_{basic text-to-image generation}| | **I2I** | 소스 이미지 기반 변형 생성
_{source image-based transformation}| | **EDIT** | 레퍼런스 이미지 1~5장 기반 멀티 레퍼런스 편집
_{multi-reference editing based on 1–5 reference images}| | **PAINT** | 내장 마스크 에디터로 특정 영역 재생성 + Outpaint 지원
_{built-in mask editor regenerate selected areas with Outpaint support}| | **FACESWAP** | BFS 얼굴 LoRA를 사용한 얼굴 교체·재생성
_{BFS face replacement and regeneration using a BFS face LoRA}| | **UPSCALE** | SeedVR2 AI 업스케일 — DiT 모델 기반 초고해상도 변환
_{SeedVR2 AI — DiT ultra-high-resolution conversion using a DiT model}| ### 필수 모델 ### Required Models | 종류
_Type| 경로
_Path| 다운로드
_Download| |---|---|---| | Diffusion Model | `models/diffusion_models/` | [BFL FLUX.2 Collection](https://huggingface.co/collections/black-forest-labs/flux2) | | Text Encoder (9B) | `models/text_encoders/` | [Comfy-Org 9B pack](https://huggingface.co/Comfy-Org/vae-text-encorder-for-flux-klein-9b) | | Text Encoder (4B) | `models/text_encoders/` | [Comfy-Org 4B pack](https://huggingface.co/Comfy-Org/vae-text-encorder-for-flux-klein-4b) | | VAE | `models/vae/` | [Comfy-Org 9B pack](https://huggingface.co/Comfy-Org/vae-text-encorder-for-flux-klein-9b) | | BFS LoRA (Faceswap) | `models/loras/` | [BFS-Best-Face-Swap](https://huggingface.co/Alissonerdx/BFS-Best-Face-Swap) | > **KV Cache**: 파일명에 `kv`가 포함된 모델은 자동으로 FluxKVCache 노드를 활성화합니다. > **KV Cache**: Models whose filenames contain `kv` automatically FluxKVCache enable the node. --- ## Qwen Image Edit 2511 ONE STUDIO — 기능 상세 ## Qwen Image Edit 2511 ONE STUDIO — Feature Details ### 지원 모드 ### Supported Modes | 모드
_Mode| 설명
_Description| |---|---| | **T2I** | 텍스트로 이미지 생성
_{generate an image from text}| | **I2I** | 소스 이미지 기반 변형 생성
_{source image-based transformation}| | **EDIT** | 텍스트 프롬프트로 이미지 편집. 원본 + 참조 이미지 최대 3장 지원
_{edit images using a text prompt. supports the original plus up to three reference images}| | **PAINT** | 마스크 영역 인페인트. Outpaint(캔버스 확장) 포함
_{inpaint masked areas. Outpaint(canvas expansion) included}| | **FACESWAP** | BFS LoRA를 활용한 얼굴 교체. 자동 기본 프롬프트 제공
_{BFS LoRAface replacement using BFS LoRA. provides an automatic default prompt}| | **ANGLE** | 3D 씬에서 카메라 앵글(H/V/Z) 드래그 조절. Camera Angle LoRA는 ⚙ Settings에서 설정
_{3D scene camera angle(H/V/Z) drag control. Camera Angle LoRAis configured in ⚙ Settings}| | **UPSCALE** | SeedVR2 AI 업스케일
_{SeedVR2 AI}| ### 필수 모델 ### Required Models | 종류
_Type| 경로
_Path| 다운로드
_Download| |---|---|---| | Diffusion Model | `models/diffusion_models/` | [Comfy-Org QE2511](https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI/tree/main/split_files/diffusion_models) | | Text Encoder | `models/text_encoders/` | [Comfy-Org QE2511](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/tree/main/split_files/text_encoders) | | VAE | `models/vae/` | [Comfy-Org QE2511](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/tree/main/split_files/vae) | | Lightning LoRA (선택)
_{Lightning LoRA (selection)}| `models/loras/` | [Qwen-Image-Edit-2511-Lightning](https://huggingface.co/lightx2v/Qwen-Image-Edit-2511-Lightning/tree/main) | | Camera Angle LoRA (선택)
_{Camera Angle LoRA (selection)}| `models/loras/` | [Multi Angle LoRa](https://huggingface.co/fal/Qwen-Image-Edit-2511-Multiple-Angles-LoRA) | | BFS LoRA (Faceswap 필수)
_{BFS LoRA (Faceswap required)}| `models/loras/` | [BFS-Best-Face-Swap](https://huggingface.co/Alissonerdx/BFS-Best-Face-Swap) | > **내부 의존 노드**: `FluxKontextImageScale` · `TextEncodeQwenImageEditPlus` · `FluxKontextMultiReferenceLatentMethod` — ComfyUI-KJNodes에 포함 > **Internal Dependency Nodes**: `FluxKontextImageScale` · `TextEncodeQwenImageEditPlus` · `FluxKontextMultiReferenceLatentMethod` — ComfyUI-KJNodesincluded in --- ## Krea 2 ONE STUDIO — 기능 상세 ## Krea 2 ONE STUDIO — Feature Details ### 지원 모드 ### Supported Modes | 모드
_Mode| 설명
_Description| |---|---| | **T2I** | 텍스트로 이미지 생성 (+ ControlNet depth/canny 🧪)
_{generate an image from text (+ ControlNet depth/canny 🧪)}| | **I2I** | 소스 이미지 기반 변형 생성 (+ ControlNet depth/canny 🧪)
_{source image-based transformation (+ ControlNet depth/canny 🧪)}| | **IDENTITY** 🧪 | 지시문 기반 인물 정체성/외형 편집
_{instruction-based identity / appearance editing}| | **UPSCALE** | SeedVR2 AI 업스케일
_{SeedVR2 AI}| ### 필수 모델 ### Required Models | 종류
_Type| 경로
_Path| 다운로드
_Download| |---|---|---| | Diffusion Model | `models/diffusion_models/` | [Comfy-Org Krea2](https://huggingface.co/Comfy-Org/Krea-2/tree/main/diffusion_models) | | Text Encoder | `models/text_encoders/` | [Comfy-Org Krea2](https://huggingface.co/Comfy-Org/Krea-2/tree/main/text_encoders) | | VAE | `models/vae/` | [Comfy-Org Krea2](https://huggingface.co/Comfy-Org/Krea-2/tree/main/vae) | ### 🧪 IDENTITY · ControlNet (depth / canny) — 실험적 기능 ### 🧪 IDENTITY · ControlNet (depth / canny) — Experimental Features > ⚠️ **실험적 기능 · 오류 가능성 있음 (Experimental — may produce errors or unexpected results)** > IDENTITY 탭과 ControlNet(depth/canny)은 외부 커스텀 노드 + 별도 LoRA에 의존하는 실험적 기능입니다. 결과 품질이 일정하지 않을 수 있고, 노드/모델 미설치 시 생성이 실패합니다. depth·canny는 **LoRA 기반**이라 픽셀 단위로 정확하지 않습니다. > The IDENTITY tab and ControlNet (depth/canny) are experimental and depend on external custom nodes + separate LoRAs. Output quality can be inconsistent, and generation fails if the required nodes/models are missing. Because depth/canny are **LoRA-based**, they are not pixel-accurate. > > - **Depth** = 전체 구도·프레이밍·스케일을 잡음(세밀한 포즈는 느슨) / captures overall composition·framing·scale (loose on fine pose) > - **Canny** = 윤곽선을 정확히 고정해 포즈·얼굴 방향·실루엣 재현 / locks contours for faithful pose·face-direction·silhouette **필수 커스텀 노드 (Required custom nodes)** | 노드
_Node| 기능
_{Used for}| |---|---| | [comfyui-krea2edit](https://github.com/lbouaraba/comfyui-krea2edit) | IDENTITY (`Krea2EditModelPatch` · `Krea2EditGroundedEncode`) | | [comfyui-krea2-controlnet](https://github.com/facok/comfyui-krea2-controlnet) | ControlNet **Depth** (`Krea2ControlLoRALoader` · `…ImageEncode` · `…Apply`) | | [ComfyUI-NK2E](https://github.com/Nynxz/ComfyUI-NK2E) | ControlNet **Canny** (`NK2EInContextEditNode`) | | [comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) | depth/canny 전처리기 (`DepthAnythingV2Preprocessor` · `CannyEdgePreprocessor`) | **필수 LoRA / 모델 (Required LoRAs / models) — `models/loras/` 에 배치** | 기능
_Feature| 파일
_File| 다운로드
_Download| |---|---|---| | IDENTITY | `krea2_identity_edit_v1_2.safetensors` | [conradlocke/krea2-identity-edit](https://huggingface.co/conradlocke/krea2-identity-edit) | | Depth ControlNet | depth control LoRA (예: `depth-control-lora.safetensors`) | [Patil/Krea-2-depth-controlnet](https://huggingface.co/Patil/Krea-2-depth-controlnet) | | Canny ControlNet | NK2E canny LoRA (예: `NK2E-canny-v0.1.safetensors`) | [nynxz/NK2E](https://huggingface.co/nynxz/NK2E) | > **Depth 전처리 모델 자동 다운로드**: depth 사용 시 `depth_anything_v2_vitl.pth`(Large, 권장)가 첫 실행에 `comfyui_controlnet_aux/ckpts/depth-anything/…` 로 자동 다운로드됩니다. (vitb/vits도 선택 가능. **vitg(Giant)는 저장소가 비공개라 지원 안 함.**) > **Depth preprocessor auto-download**: on first use, `depth_anything_v2_vitl.pth` (Large, recommended) is auto-downloaded to `comfyui_controlnet_aux/ckpts/depth-anything/…`. (vitb/vits selectable too. **vitg (Giant) is unsupported — its repo is gated.**) **설정 방법 (Setup)** 1. 위 커스텀 노드 설치 후 ComfyUI 재시작 / install the nodes above, restart ComfyUI 2. LoRA 파일을 `models/loras/` 에 배치 / place the LoRA files in `models/loras/` 3. ⚙ **Settings** 에서 IDENTITY LoRA, Depth/Canny Control LoRA **파일만 등록** / register only the LoRA **files** in Settings 4. 조절값(strength·임계값·depth 모델·해상도 등)은 **사이드 메뉴 CONTROLNET 패널**에서 직접 조절 / adjust all tuning values in the **side-menu CONTROLNET panel** --- ## SDXL ONE STUDIO — 기능 상세 🧪 ## SDXL ONE STUDIO — Feature Details 🧪 > 🧪 **테스트 버전 (Test / Beta Version)** > SDXL ONE STUDIO는 현재 테스트 단계입니다. 핵심 기능은 동작하지만 UI 및 옵션이 향후 변경될 수 있습니다. > SDXL ONE STUDIO is currently in the test stage. Core features are functional, but the UI and options may change in future versions. ### 지원 모드 ### Supported Modes | 모드
_Mode| 설명
_Description| |---|---| | **T2I** | 텍스트 → 이미지 기본 생성
_{basic text-to-image generation}| | **I2I** | 소스 이미지 기반 변형 생성
_{source image-based transformation}| | **INPAINT** | 내장 풀스크린 마스크 에디터 (줌 1x–32x · 팬 · 브러시/지우개) — VAEEncodeForInpaint로 완전 마스킹
_{built-in full-screen mask editor (zoom 1x–32x · pan · brush/eraser) — fully masked with VAEEncodeForInpaint}| | **OUTPAINT** | 이미지 캔버스 확장 후 빈 영역 인페인트. 비교 슬라이더에서 패딩된 원본 미리보기 제공
_{extend the image canvas and inpaint empty areas. padded original preview in compare slider}| | **UPSCALE** | ESRGAN AI 업스케일 (latent 확대 → Refiner KSampler 정제)
_{ESRGAN AI upscale (latent upscale → Refiner KSampler refinement)}| ### 모델 로딩 방식 ### Model Loading Mode SDXL ONE STUDIO는 Settings에서 두 가지 로딩 방식을 지원합니다. SDXL ONE STUDIO supports two model loading modes in Settings. | 방식
_Mode| 설명
_Description| |---|---| | **CKPT** | 단일 Checkpoint 파일 (`models/checkpoints/`) — 가장 간단한 방식
_{single Checkpoint file (`models/checkpoints/`) — simplest setup}| | **Separate (UNET)** | UNET + DualCLIP(L/G) + VAE 분리 로딩 — GGUF·FP8 경량 모델 지원
_{separate UNET + DualCLIP(L/G) + VAE loading — supports GGUF·FP8 lightweight models}| > **Refiner**: CKPT / Separate 방식 모두 별도 Refiner Checkpoint를 항상 설정할 수 있습니다. Refiner는 `CheckpointLoaderSimple`로 독립 로딩됩니다. > **Refiner**: In both CKPT and Separate modes, a separate Refiner Checkpoint can always be configured. The Refiner is loaded independently via `CheckpointLoaderSimple`. ### 주요 기능 ### Key Features | 기능
_Feature| 설명
_Description| |---|---| | **📋 프롬프트 템플릿**
_{📋 Prompt Template}| 자주 쓰는 프롬프트 저장·불러오기 (Klein 공유 템플릿 DB 사용)
_{save and load frequently used prompts (shared template DB with Klein)}| | **🔍 프롬프트 확대 편집**
_{🔍 Prompt Expand Edit}| 전체화면 편집 팝업. TJ_NODE 설치 시 ✨ Enhance · 🖼 Image→Prompt 자동 활성화
_{fullscreen edit popup. TJ_NODE install enables ✨ Enhance · 🖼 Image→Prompt}| | **CKPT ↔ UNET 표시기**
_{CKPT ↔ UNET Indicator}| 현재 로딩 방식을 상단 배지로 표시. 방식 전환 시 즉시 업데이트
_{display current loading mode as a top badge. Updates instantly on mode change}| | **⇌ 비교 슬라이더**
_{⇌ Compare Slider}| Outpaint: 패딩된 원본 vs 결과 / Inpaint: 원본 vs 마스킹 결과
_{Outpaint: padded original vs result / Inpaint: original vs masked result}| | **마스크 에디터**
_{Mask Editor}| 팝업 풀스크린 에디터 — 줌·팬·브러시/지우개·크기 슬라이더 내장
_{popup fullscreen editor — zoom · pan · brush/eraser · size slider built-in}| ### 필수 모델 ### Required Models | 종류
_Type| 경로
_Path| 비고
_Notes| |---|---|---| | **SDXL Checkpoint** (CKPT 방식) | `models/checkpoints/` | 일반 SDXL .safetensors 파일
_{standard SDXL .safetensors file}| | **SDXL UNET** (Separate 방식) | `models/diffusion_models/` | GGUF / FP8 경량 파일도 지원
_{GGUF / FP8 lightweight files also supported}| | **CLIP-L** (Separate 방식) | `models/text_encoders/` | SDXL dual-encoder: clip_l
_{SDXL dual-encoder: clip_l}| | **CLIP-G** (Separate 방식) | `models/text_encoders/` | SDXL dual-encoder: clip_g
_{SDXL dual-encoder: clip_g}| | **VAE** (Separate 방식) | `models/vae/` | sdxl_vae.safetensors 등
_{sdxl_vae.safetensors etc.}| | **Refiner Checkpoint** (선택)
_{Refiner Checkpoint (optional)}| `models/checkpoints/` | SDXL-Refiner 계열 모델
_{SDXL-Refiner series model}| | **ESRGAN Upscale** (Upscale 시 필수)
_{ESRGAN Upscale (required for Upscale)}| `models/upscale_models/` | 4x-UltraSharp 등
_{4x-UltraSharp etc.}| --- ## 공통 기능 ## Common Features ### 설정 패널 (⚙ Settings) ### Settings Panel (⚙ Settings) - **Diffusion Model / Text Encoder / VAE** 드롭다운 선택 - **Diffusion Model / Text Encoder / VAE** dropdown selection - **↻ Refresh Models** — 모델 폴더 재스캔 (ComfyUI 재시작 없이 새 파일 인식) - **↻ Refresh Models** — rescan model folders (recognize new files without restarting ComfyUI) - **언어 / Language** — 한국어 / English 전환 (페이지 새로고침 적용) - ** / Language** — Korean / English before (applied after page refresh) - **Negative Prompt** — 전체 모드 공통 적용 - **Negative Prompt** — applied to all modes - **Prompt Suffix** — 프롬프트 뒤에 자동 추가 - **Prompt Suffix** — automatically appended to the prompt - **Save Folder** — `ComfyUI/output/` 내부 하위 저장 폴더 지정 - **Save Folder** — `ComfyUI/output/` specify a subfolder under ComfyUI/output - **모델 오버라이드 슬롯** — Primitive(String) 노드 연결로 설정 드롭다운 우선 적용 - **Model Override Slots** — Primitive(String) connect a Primitive(String) node to override the Settings dropdown ### SeedVR2 Upscale 모델 (전체 노드 공용) ### SeedVR2 Upscale model (shared by all nodes) | 경로
_Path| 파일
_File| 다운로드
_Download| |---|---|---| | `models/SEEDVR2/` | DiT + VAE 모델
_{DiT + VAE model}| [SeedVR2-models](https://huggingface.co/numz/SeedVR2_comfyUI/tree/main) | ### LoRA - 최대 3개 LoRA 체인 (Faceswap 모드는 1개) - up to three LoRA chains (Faceswap one in Faceswap mode) - `.safetensors` 헤더에서 트리거 워드 자동 추출 및 표시 - `.safetensors` automatically extract and display trigger words from the .safetensors header - LoRA 교체 시 트리거 워드 자동 초기화 후 새 LoRA 트리거 워드 재로드 - when changing LoRA, clear the old trigger word and reload the new LoRA trigger word - ON/OFF 토글로 개별 활성화 - ON/OFF individually enable with the ON/OFF toggle - Strength 0~2 조절 (0 값 정상 저장) - Strength 0~2 adjustment (0 value is saved correctly) ### 갤러리 (🖼 Gallery) ### Gallery (🖼 Gallery) - 저장된 이미지 타일 보기 (무한 스크롤, 정사각형 그리드) - view saved images as tiles (infinite scrolling, square grid) - 즐겨찾기(★) / 삭제 / 폴더 열기 / Send to(모드에 이미지 전달) - favorite(★) / delete / open folder / Send to(send image to a mode) - ESC 키로 닫기 - ESC close with the ESC key ### 비교 슬라이더 (⇌ Compare) ### Comparison Slider (⇌ Compare) - 생성 전 원본과 생성 후 결과를 드래그로 나란히 비교 - drag the slider to compare the original and generated result side by side ### 단축키 ### Keyboard Shortcuts | 키
_Key| 동작
_Action| |---|---| | `ESC` | 열린 팝업 / 갤러리 / 오버레이 닫기
_{close open popups, Gallery, or overlays}| --- ## 버그 수정 이력 ## Bug Fix History ### v1.5.0 (현재) - **[Krea2] I2I ControlNet 추가** — comfyui-krea2-controlnet 통합. I2I 탭 하단에 ControlNet 패널 추가. Control LoRA 선택 + 강도 + Channel Mode(RGB/Grayscale) + Normalize + Invert + 컨트롤 이미지 업로드. ON/OFF 토글로 기존 I2I와 동일하게 사용 가능. Depth Control LoRA: [Patil/Krea-2-depth-controlnet](https://huggingface.co/Patil/Krea-2-depth-controlnet) ### v1.4.1 ### v1.4.1 (Current) - **[전체] LoRA 트리거 워드 초기화 버그 수정**: `loraSelect` 검색 필터 입력 시 표시값(`s.value`)이 아닌 내부 `currentValue` 기준으로 복원하도록 수정 — `availableLoras` 로드 전 UI가 "none"으로 표시된 상태에서 검색 타이핑 시 currentValue가 오염되던 문제 해결 - **[All] LoRA fixed the LoRA trigger-word reset bug**: `loraSelect` when typing in the search filter display value(`s.value`)instead of the internal `currentValue` restored based on — `availableLoras` before availableLoras was loaded, the UI "none"fixed an issue where typing in search while displayed as "none" corrupted currentValue - **[전체] LoRA 교체 시 트리거 워드 재로드**: 다른 LoRA로 교체하면 이전 트리거 워드를 초기화하고 새 트리거 워드를 자동 fetch. 같은 LoRA 재선택 시에는 기존 트리거 워드 유지 - **[All] reload trigger words when changing LoRA**: when switching to another LoRA, clear the previous trigger word and automatically fetch the new one. reselecting the same LoRA preserves the existing trigger word - **[전체] strength 0 저장 버그 수정**: `parseFloat(v) || 1` 연산으로 strength=0 설정 시 항상 1로 리셋되던 문제 수정 → `isNaN(v) ? 1 : v`로 변경 - **[All] strength 0 fixed the save bug**: `parseFloat(v) || 1` fixed an issue where setting strength=0 always reset it to 1 because of the operation → `isNaN(v) ? 1 : v`changed to ### v1.2 - **[전체] 언어 지원 추가**: QE2511 · Krea2 Settings에 한국어/English 언어 선택기 추가 - **[All] added language support**: QE2511 · Krea2 Settings Korean/English added a Korean/English language selector - **[전체] 도움말 개선**: QE2511 · Krea2 도움말을 Z-Image 스타일로 전면 재작성 (모델 다운로드 URL 포함, 클릭 가능 링크) - **[All] improved Help**: QE2511 · Krea2 completely rewrote QE2511 and Krea2 Help in the Z-Image style (including model download URLs, clickable links) - **[Klein · QE2511] Outpaint 색상 버그 수정**: `ImagePadKJ`의 color 파라미터를 `[R,G,B]` 배열(ComfyUI가 노드 링크로 오해 → "Bad linked input" 오류)에서 `"R, G, B"` 문자열 형식으로 수정 - **[Klein · QE2511] Outpaint fixed the Outpaint color bug**: `ImagePadKJ`changed the ImagePadKJ color parameter from `[R,G,B]` array(which ComfyUI misinterpreted as a node link → "Bad linked input" error)to `"R, G, B"` string format - **[Klein] Outpaint 레퍼런스 불인식 버그 수정**: `GetImageSize`가 패딩 전 원본 이미지를 읽어 `EmptyFlux2LatentImage`와 `VAEEncode`의 해상도가 불일치 → 모델이 레퍼런스 컨디셔닝을 무시하고 완전히 새 이미지를 생성하던 문제 수정. `GetImageSize`가 `ImageScaleToTotalPixels` 출력(스케일된 패딩 이미지)을 읽도록 변경 - **[Klein] Outpaint fixed the Outpaint reference recognition bug**: `GetImageSize`GetImageSize read the original image before padding, causing `EmptyFlux2LatentImage`and `VAEEncode`to have mismatched resolutions → fixed an issue where the model ignored reference conditioning and generated a completely new image. `GetImageSize` `ImageScaleToTotalPixels` output(scaled padded image)now reads ### v1.1 - **[QE2511]** `FluxKontextMakeReferenceLatent` 노드 제거 (미설치 오류 수정) → `FluxKontextMultiReferenceLatentMethod`에 vaeEnc 직접 연결 - **[QE2511]** `FluxKontextMakeReferenceLatent` removed the node (fixed missing-node errors) → `FluxKontextMultiReferenceLatentMethod`connected vaeEnc directly to FluxKontextMultiReferenceLatentMethod - **[QE2511]** Camera Angle LoRA를 ⚙ Settings 패널로 이동 (영구 저장) - **[QE2511]** Camera Angle LoRA ⚙ Settings moved to the Settings panel (persistent storage) - **[QE2511]** ANGLE 모드 카메라 바디 핑크 블롭 → 작은 점으로 교체 - **[QE2511]** ANGLE ANGLE mode camera-body pink blob → replaced with a small dot - **[QE2511]** ANGLE 모드 Send To 대상 추가 (→ Edit, → I2I, → Paint, → Upscale) - **[QE2511]** ANGLE Mode Send To added Send To targets (→ Edit, → I2I, → Paint, → Upscale) - **[QE2511]** Send To Edit 모드 필드명 버그 수정 (`editImage` → `editImage1`) - **[QE2511]** Send To Edit fixed the Send To Edit field-name bug (`editImage` → `editImage1`) - **[QE2511]** FACESWAP 모드 진입 시 기본 프롬프트 자동 설정 - **[QE2511]** FACESWAP automatically sets the default prompt when entering FACESWAP mode - **[QE2511 · Krea2]** 갤러리 그리드 `gridAutoRows: 120px` 추가로 정사각형 타일 수정 - **[QE2511 · Krea2]** Gallery `gridAutoRows: 120px` added to fix square Gallery tiles --- ## 함께 쓰면 더 강력한 — TJ_NODE ## More Powerful Together with — TJ_NODE > **[ComfyUI-TJ_NODE](https://github.com/designloves2/ComfyUI-TJ_NODE)** — Wireless Workflow Architecture Toolkit | TJ_NODE 주요 노드
_{TJ_NODE Key Nodes}| 기능
_Feature| |---|---| | **Prompt Studio (TJ)** | LLM 기반 프롬프트 생성 · 강화 · 이미지→프롬프트 변환
_{LLM LLM-based prompt generation, enhancement, and image-to-prompt conversion}| | **Scene Maker (TJ)** | Visual Beat 프롬프트 구조 노드. KO/EN/JP/CN 자동 번역
_{Visual Beat Visual Beat prompt-structure node. KO/EN/JP/CN automatic translation}| | **Wireless Architecture** | Fake-Wire 무선 라우팅 · Multi Router · Batch Workflow
_{Fake-Wire wireless routing · Multi Router · Batch Workflow}| ### ✨ 인노드 LLM 통합 (v1.4+) ### ✨ In-Node LLM Integration (v1.4+) TJ_NODE가 설치되어 있으면 **4개 노드 모두**의 프롬프트 확대창(`🔍` 버튼)에서 LLM 기능이 자동 활성화됩니다. TJ_NODEWhen TJ_NODE is installed **all four nodes**prompt expansion window(`🔍` button)automatically enables LLM features. | 탭
_Tab| 기능
_Feature| |---|---| | **✏️ Edit** | 기존 전체화면 텍스트 편집 (변경 없음)
_{existing full-screen text editor (unchanged)}| | **✨ Enhance** | 현재 프롬프트를 GGUF LLM으로 강화. Model Format · Aesthetic · Extra Instructions 설정 지원
_{enhance the current prompt with a GGUF LLM. Model Format · Aesthetic · Extra Instructions supports settings}| | **🖼 Image→Prompt** | 이미지 업로드 또는 **URL 다운로드** → 비전 LLM으로 프롬프트 생성 → 현재 모드에 전송
_{upload an image or **download from a URL** → generate a prompt with a vision LLM → send it to the current mode}| - GGUF 모델·설정이 **자동 기억**되어 매번 다시 선택할 필요 없음 (4개 노드 공유) - GGUF models and settings are **remembered automatically**so they do not need to be selected every time (shared by all four nodes) - 이미지 전송 전 **1MP 이하 자동 리사이즈** — Context Overflow 방지 - before sending an image **1MP automatically resize to 1 MP or less** — Context Overflow prevention - AI 처리 중 **링 스피너 오버레이**로 진행 상태 시각 표시 - AI during AI processing **ring spinner overlay**visually displays progress - TJ_NODE 미설치 시 확대창 안 **⬇ 설치 버튼** 한 번으로 자동 설치 (git clone + pip) - TJ_NODE if TJ_NODE is not installed, use the **⬇ install button** to install automatically with one click (git clone + pip) - ComfyUI Manager 미등록 상태이므로 수동 설치: `git clone https://github.com/designloves2/ComfyUI-TJ_NODE` - ComfyUI Manager is not registered in ComfyUI Manager, so install it manually: `git clone https://github.com/designloves2/ComfyUI-TJ_NODE` **→ [github.com/designloves2/ComfyUI-TJ_NODE](https://github.com/designloves2/ComfyUI-TJ_NODE)** --- # TJ NODE STUDIO ONE — 설치 및 설정 가이드 # TJ NODE STUDIO ONE — Installation and Configuration Guide > **Z-Image ONE STUDIO · Flux.2 Klein ONE STUDIO · Qwen Image Edit 2511 ONE STUDIO · Krea 2 ONE STUDIO** > ComfyUI 올인원 이미지 생성 UI — 워크플로우 배선 없이 노드 하나에서 T2I · I2I · Inpaint · Outpaint · Edit · Faceswap · Upscale 등 모든 모드를 전환합니다. > ComfyUI image generation UI — switch between modes in a single node without workflow wiring T2I · I2I · Inpaint · Outpaint · Edit · Faceswap · Upscale etc. Mode before. --- ## 목차 ## Table of Contents 1. [TJ NODE 패키지](#1-tj-node-패키지) 1. [TJ NODE Package](#1-tj-node-패키지) 2. [필수 커스텀 노드](#2-필수-커스텀-노드) 2. [Required Custom Nodes](#2-필수-커스텀-노드) 3. [모델 다운로드](#3-모델-다운로드) 3. [Model Downloads](#3-모델-다운로드) 4. [초기 설정](#4-초기-설정) 4. [Initial Setup](#4-초기-설정) 5. [모드별 간략 설명](#5-모드별-간략-설명) 5. [Mode Overview](#5-모드별-간략-설명) 6. [문제 해결](#6-문제-해결) 6. [Troubleshooting](#6-문제-해결) --- ## 1. TJ NODE 패키지 ## 1. TJ NODE Package ### 이 패키지 (통합 설치) ### This Package (Unified Installation) | 패키지
_Package| 설명
_Description| GitHub | | ---------------------- | ------------------------------------------------ | ------------------------------------------------------------ | | **TJ_NODE_STUDIO_ONE** | Z-Image · Klein · QE2511 · Krea2 ONE STUDIO 통합
_{Z-Image · Klein · QE2511 · Krea2 ONE STUDIO}| [ComfyUI-TJ_NODE_STUDIO_ONE](https://github.com/designloves2/ComfyUI-TJ_NODE_STUDIO_ONE) | > **설치**: ComfyUI Manager → Install Custom Nodes → `ComfyUI-TJ_NODE_STUDIO_ONE` 검색 > **Installation**: ComfyUI Manager → Install Custom Nodes → `ComfyUI-TJ_NODE_STUDIO_ONE` > 또는 수동: `cd ComfyUI/custom_nodes && git clone https://github.com/designloves2/ComfyUI-TJ_NODE_STUDIO_ONE.git` > or manually: `cd ComfyUI/custom_nodes && git clone https://github.com/designloves2/ComfyUI-TJ_NODE_STUDIO_ONE.git` ### 함께 쓰면 더 강력한 — TJ_NODE ### More Powerful Together with — TJ_NODE | 패키지
_Package| 설명
_Description| GitHub | | ----------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | **TJ_NODE** | Wireless Workflow Architecture Toolkit — LLM 프롬프트 생성 · Fake-Wire 무선 라우팅 · 대규모 워크플로우 구조화
_{Wireless Workflow Architecture Toolkit — LLM generation · Fake-Wire wireless routing ·}| [ComfyUI-TJ_NODE](https://github.com/designloves2/ComfyUI-TJ_NODE) | --- ## 2. 필수 커스텀 노드 ## 2. Required Custom Nodes ### ⚡ 자동 설치 스크립트 (권장) ### ⚡ Automatic Installation (recommended) 이 패키지 폴더(`ComfyUI-TJ_NODE_STUDIO_ONE/`) 안에 설치 스크립트가 포함되어 있습니다. This Package (`ComfyUI-TJ_NODE_STUDIO_ONE/`) Installation included . 필수 노드 **8개를 한 번에** 설치하고 pip requirements까지 처리합니다. required Node **8 ** Installation pip requirements . **Windows** — 파일 탐색기에서 더블클릭: **Windows** — double-click in File Explorer: ``` install_requirements.bat ``` **Mac / Linux** — 터미널에서 실행: **Mac / Linux** — run in Terminal: ```bash chmod +x install_requirements.sh ./install_requirements.sh ``` > 이미 설치된 노드는 자동으로 건너뜁니다. 완료 후 ComfyUI를 재시작하세요. > Already installed nodes are skipped automatically. Restart ComfyUI when installation is complete. --- ### 수동 설치 목록 ### Manual Installation List | 커스텀 노드
_{Custom Node}| 용도
_Purpose| 필요 노드
_{Required Node}| GitHub | | -------------------------- | ------------------------------------------------ | ----------------------- | ------------------------------------------------------------ | | **ComfyUI-Impact-Pack** | FaceDetailer — 얼굴 감지·재생성·블렌드 핵심 엔진
_{FaceDetailer — core engine for face detection, regeneration, and blending}| Z-Image · Face Redraw | [ltdrdata/ComfyUI-Impact-Pack](https://github.com/ltdrdata/ComfyUI-Impact-Pack) | | **ComfyUI-Impact-Subpack** | Impact Pack 의존 서브팩
_{Impact Pack dependency subpack}| Z-Image · Face Redraw | [ltdrdata/ComfyUI-Impact-Subpack](https://github.com/ltdrdata/ComfyUI-Impact-Subpack) | | **ComfyUI-KJNodes** | FluxKVCache · ImagePadKJ · FluxKontext 노드 포함
_{FluxKVCache · ImagePadKJ · FluxKontext Node included}| Klein · QE2511 | [kijai/ComfyUI-KJNodes](https://github.com/kijai/ComfyUI-KJNodes) | | **ComfyUI-GGUF** | GGUF 양자화 모델 로딩
_{GGUF model}| 선택 (GGUF 사용 시)
_{selection (GGUF when used)}| [city96/ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF) | | **ComfyUI_FaceAnalysis** | Faceswap 얼굴 임베딩 분석
_{Faceswap face embedding analysis}| Klein · QE2511 Faceswap | [cubiq/ComfyUI_FaceAnalysis](https://github.com/cubiq/ComfyUI_FaceAnalysis) | | **ComfyUI-RMBG** | 배경 제거 (RE-BG 모드)
_{background removal (RE-BG Mode)}| Z-Image · RE-BG | [1038lab/ComfyUI-RMBG](https://github.com/1038lab/ComfyUI-RMBG) | | **comfyui_controlnet_aux** | ControlNet 전처리기 (Depth · Canny · Pose 등)
_{ControlNet preprocessor (Depth · Canny · Pose etc.)}| Z-Image · ControlNet | [Fannovel16/comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) | | **ComfyUI-SeedVR2** | SeedVR2 AI 업스케일 (UPSCALE 모드)
_{SeedVR2 AI (UPSCALE Mode)}| 전체 노드
_{All Node}| [numz](https://github.com/numz) [ComfyUI-SeedVR2_VideoUpscaler](https://github.com/numz/ComfyUI-SeedVR2_VideoUpscaler) | --- ## 3. 모델 다운로드 ## 3. Model Downloads ### 3-1. Z-Image ONE STUDIO 모델 ### 3-1. Z-Image ONE STUDIO model #### Diffusion Model → `models/diffusion_models/` | 파일명
_File| 설명
_Description| 다운로드
_Download| | -------------------------------- | --------------------------- | ------------------------------------------------------------ | | `z_image_turbo_bf16.safetensors` | Z-Image Turbo BF16 **권장**
_{Z-Image Turbo BF16 **recommended**}| [다운로드](https://huggingface.co/Comfy-Org/z_image_turbo/resolve/main/split_files/diffusion_models/z_image_turbo_bf16.safetensors)
_{[Download](https://huggingface.co/Comfy-Org/z_image_turbo/resolve/main/split_files/diffusion_models/z_image_turbo_bf16.safetensors)}| > 전체 모델 목록: https://huggingface.co/Comfy-Org/z_image_turbo > Full model list: https://huggingface.co/Comfy-Org/z_image_turbo #### Text Encoder → `models/text_encoders/` | 파일명
_File| 다운로드
_Download| | ----------------------- | ------------------------------------------------------------ | | `qwen_3_4b.safetensors` | [다운로드](https://huggingface.co/Comfy-Org/z_image_turbo/resolve/main/split_files/text_encoders/qwen_3_4b.safetensors)
_{[Download](https://huggingface.co/Comfy-Org/z_image_turbo/resolve/main/split_files/text_encoders/qwen_3_4b.safetensors)}| #### VAE → `models/vae/` | 파일명
_File| 다운로드
_Download| | ---------------- | ------------------------------------------------------------ | | `ae.safetensors` | [다운로드](https://huggingface.co/Comfy-Org/z_image_turbo/resolve/main/split_files/vae/ae.safetensors)
_{[Download](https://huggingface.co/Comfy-Org/z_image_turbo/resolve/main/split_files/vae/ae.safetensors)}| #### ControlNet → `models/controlnet/` *(ControlNet 모드 사용 시)* #### ControlNet → `models/controlnet/` *(ControlNet Mode when used)* | 파일명
_File| 다운로드
_Download| | ------------------------------------------------ | ------------------------------------------------------------ | | `Z-Image-Turbo-Fun-Controlnet-Union.safetensors` | [다운로드](https://huggingface.co/alibaba-pai/Z-Image-Turbo-Fun-Controlnet-Union/resolve/main/Z-Image-Turbo-Fun-Controlnet-Union.safetensors)
_{[Download](https://huggingface.co/alibaba-pai/Z-Image-Turbo-Fun-Controlnet-Union/resolve/main/Z-Image-Turbo-Fun-Controlnet-Union.safetensors)}| #### Face Detector → `models/ultralytics/bbox/` *(Face Redraw 모드 사용 시)* #### Face Detector → `models/ultralytics/bbox/` *(Face Redraw Mode when used)* | 파일명
_File| 다운로드
_Download| | -------------------------- | ------------------------------------------------------------ | | `face_yolov8m.pt` **권장**
_{`face_yolov8m.pt` **recommended**}| [다운로드](https://huggingface.co/Bingsu/adetailer/resolve/main/face_yolov8m.pt)
_{[Download](https://huggingface.co/Bingsu/adetailer/resolve/main/face_yolov8m.pt)}| | `face_yolov9c.pt` | [다운로드](https://huggingface.co/Bingsu/adetailer/resolve/main/face_yolov9c.pt)
_{[Download](https://huggingface.co/Bingsu/adetailer/resolve/main/face_yolov9c.pt)}| #### BG Removal → `models/background_removal/` *(RE-BG 모드 사용 시)* #### BG Removal → `models/background_removal/` *(RE-BG Mode when used)* | 다운로드
_Download| | | ------------------------------------------------------------ | ---- | | [Comfy-Org/BiRefNet — background_removal](https://huggingface.co/Comfy-Org/BiRefNet/tree/main/background_removal) | | --- ### 3-2. Flux.2 Klein ONE STUDIO 모델 ### 3-2. Flux.2 Klein ONE STUDIO model #### Diffusion Model → `models/diffusion_models/` | 모델
_model| 설명
_Description| 다운로드
_Download| | ---------------------------- | ---------------------- | ------------------------------------------------------------ | | `flux2-klein-9b.safetensors` | FLUX.2 Klein 9B (메인)
_{FLUX.2 Klein 9B (main)}| [Black Forest Labs Collection](https://huggingface.co/collections/black-forest-labs/flux2) | | `flux2-klein-4b.safetensors` | FLUX.2 Klein 4B (경량)
_{FLUX.2 Klein 4B (lightweight)}| [Black Forest Labs Collection](https://huggingface.co/collections/black-forest-labs/flux2) | > ⚠ **9B 모델**은 HuggingFace 로그인 후 Non-Commercial License 동의 필요 > ⚠ **9B model** is HuggingFace requires Hugging Face login and acceptance of the Non-Commercial License #### Text Encoder → `models/text_encoders/` | 대상
| 다운로드
_Download| | --------- | ------------------------------------------------------------ | | 9B 모델용
_{9B for the model}| [Comfy-Org 9B — split_files/text_encoders](https://huggingface.co/Comfy-Org/vae-text-encorder-for-flux-klein-9b/tree/main/split_files/text_encoders) | | 4B 모델용
_{4B for the model}| [Comfy-Org 4B — split_files/text_encoders](https://huggingface.co/Comfy-Org/vae-text-encorder-for-flux-klein-4b/tree/main/split_files/text_encoders) | #### VAE → `models/vae/` | 다운로드
_Download| | ------------------------------------------------------------ | | [Comfy-Org 9B — split_files/vae](https://huggingface.co/Comfy-Org/vae-text-encorder-for-flux-klein-9b/tree/main/split_files/vae) | #### Faceswap LoRA → `models/loras/` *(Faceswap 모드 사용 시)* #### Faceswap LoRA → `models/loras/` *(Faceswap Mode when used)* | 파일명
_File| 다운로드
_Download| | -------------------------------------------------------- | ------------------------------------------------------------ | | `bfs_head_v1_flux-klein_9b_step3500_rank128.safetensors` | [다운로드](https://huggingface.co/Alissonerdx/BFS-Best-Face-Swap/blob/main/bfs_head_v1_flux-klein_9b_step3500_rank128.safetensors)
_{[Download](https://huggingface.co/Alissonerdx/BFS-Best-Face-Swap/blob/main/bfs_head_v1_flux-klein_9b_step3500_rank128.safetensors)}| | `bfs_head_v1_flux-klein_4b.safetensors` | [다운로드](https://huggingface.co/Alissonerdx/BFS-Best-Face-Swap/blob/main/bfs_head_v1_flux-klein_4b.safetensors)
_{[Download](https://huggingface.co/Alissonerdx/BFS-Best-Face-Swap/blob/main/bfs_head_v1_flux-klein_4b.safetensors)}| #### BG Removal → `models/background_removal/` *(Edit·Paint 마스크 사용 시)* #### BG Removal → `models/background_removal/` *(Edit·Paint when used)* | 다운로드
_Download| | ------------------------------------------------------------ | | [Comfy-Org/BiRefNet — background_removal](https://huggingface.co/Comfy-Org/BiRefNet/tree/main/background_removal) | --- ### 3-3. Qwen Image Edit 2511 ONE STUDIO 모델 ### 3-3. Qwen Image Edit 2511 ONE STUDIO model > 전체 모델 목록: https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI/tree/main/split_files > Full model list: https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI/tree/main/split_files #### Diffusion Model → `models/diffusion_models/` | 파일명
_File| 설명
_Description| 다운로드
_Download| | ------------------------------------------- | ----------------------- | ------------------------------------------------------------ | | `Qwen2.5-VL-7B-Image-Edit-bf16.safetensors` | 메인 모델 BF16 **권장**
_{main model BF16 **recommended**}| [HF 목록](https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI/tree/main/split_files/diffusion_models)
_{[HF list](https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI/tree/main/split_files/diffusion_models)}| | GGUF 경량 버전
_{GGUF lightweight version}| 저VRAM 환경
_{low-VRAM environment}| [HF 목록](https://huggingface.co/unsloth/Qwen-Image-Edit-2511-GGUF/tree/main)
_{[HF list](https://huggingface.co/unsloth/Qwen-Image-Edit-2511-GGUF/tree/main)}| #### Text Encoder (CLIPLoader qwen_image) → `models/text_encoders/` | 파일명
_File| 다운로드
_Download| | -------------------------------------- | ------------------------------------------------------------ | | `qwen2.5vl-7b-vis-encoder.safetensors` | [HF 목록](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/tree/main/split_files/text_encoders)
_{[HF list](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/tree/main/split_files/text_encoders)}| #### VAE → `models/vae/` | 파일명
_File| 다운로드
_Download| | ---------------- | ------------------------------------------------------------ | | `ae.safetensors` | [HF 목록](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/tree/main/split_files/vae)
_{[HF list](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/tree/main/split_files/vae)}| #### Lightning LoRA → `models/loras/` *(4스텝 고속 생성, 선택사항)* #### Lightning LoRA → `models/loras/` *(4 fast generation, optional)* | 파일명
_File| 다운로드
_Download| | ------------------------------------------------------------ | ------------------------------------------------------------ | | `Qwen-Image-Edit-2511-Lightning-4steps-V1.0-bf16.safetensors` | [HF 목록](https://huggingface.co/lightx2v/Qwen-Image-Edit-2511-Lightning/tree/main)
_{[HF list](https://huggingface.co/lightx2v/Qwen-Image-Edit-2511-Lightning/tree/main)}| #### Multi Angle LoRA → `models/loras/` *(Angle 모드 필수)* #### Multi Angle LoRA → `models/loras/` *(Angle Mode required)* | 파일명
_File| 다운로드
_Download| | ------------------------------------------------------- | ------------------------------------------------------------ | | `qwen-image-edit-2511-multiple-angles-lora.safetensors` | [HF 목록](https://huggingface.co/fal/Qwen-Image-Edit-2511-Multiple-Angles-LoRA)
_{[HF list](https://huggingface.co/fal/Qwen-Image-Edit-2511-Multiple-Angles-LoRA)}| #### BFS LoRA → `models/loras/` *(Faceswap 모드 필수)* #### BFS LoRA → `models/loras/` *(Faceswap Mode required)* | 다운로드
_Download| | ------------------------------------------------------------ | | [Alissonerdx/BFS-Best-Face-Swap](https://huggingface.co/Alissonerdx/BFS-Best-Face-Swap) | --- ### 3-4. Krea 2 ONE STUDIO 모델 ### 3-4. Krea 2 ONE STUDIO model > 전체 모델 목록: https://huggingface.co/Comfy-Org/Krea2 > Full model list: https://huggingface.co/Comfy-Org/Krea2 #### Diffusion Model → `models/diffusion_models/` | 설명
_Description| 다운로드
_Download| | ----- | ------------------------------------------------------------ | | Krea2 | [HF 목록](https://huggingface.co/Comfy-Org/Krea-2/tree/main/diffusion_models)
_{[HF list](https://huggingface.co/Comfy-Org/Krea-2/tree/main/diffusion_models)}| #### Text Encoder (CLIP krea2) → `models/text_encoders/` | 다운로드
_Download| | ------------------------------------------------------------ | | [HF 목록](https://huggingface.co/Comfy-Org/Krea-2/tree/main/text_encoders)
_{[HF list](https://huggingface.co/Comfy-Org/Krea-2/tree/main/text_encoders)}| #### VAE → `models/vae/` | 다운로드
_Download| | ------------------------------------------------------------ | | [HF 목록](https://huggingface.co/Comfy-Org/Krea-2/tree/main/vae)
_{[HF list](https://huggingface.co/Comfy-Org/Krea-2/tree/main/vae)}| --- ### 3-5. SDXL ONE STUDIO 모델 🧪 ### 3-5. SDXL ONE STUDIO model 🧪 > 🧪 테스트 버전 — SDXL 계열 모델을 그대로 사용합니다. > 🧪 Test Version — uses standard SDXL-family models as-is. #### Checkpoint → `models/checkpoints/` *(CKPT 방식)* #### Checkpoint → `models/checkpoints/` *(CKPT mode)* | 예시
_Example| 설명
_Description| |---|---| | `sd_xl_base_1.0.safetensors` | SDXL Base 공식 모델
_{SDXL Base official model}| | SDXL 계열 커스텀 Checkpoint | CivitAI 등에서 배포되는 SDXL 파인튠 모델
_{SDXL fine-tuned models distributed on CivitAI etc.}| #### Separate 방식 — UNET → `models/diffusion_models/` #### Separate Mode — UNET → `models/diffusion_models/` GGUF 또는 FP8 경량 SDXL UNET 파일 사용 가능. GGUF or FP8 lightweight SDXL UNET files are supported. #### Separate 방식 — Text Encoder → `models/text_encoders/` #### Separate Mode — Text Encoder → `models/text_encoders/` | 파일
_File| 설명
_Description| |---|---| | `clip_l.safetensors` | SDXL CLIP-L 텍스트 인코더
_{SDXL CLIP-L text encoder}| | `clip_g.safetensors` | SDXL CLIP-G 텍스트 인코더 (DualCLIP 필요)
_{SDXL CLIP-G text encoder (DualCLIP required)}| #### VAE → `models/vae/` | 예시
_Example| |---| | `sdxl_vae.safetensors` | #### Refiner Checkpoint (선택) → `models/checkpoints/` #### Refiner Checkpoint (optional) → `models/checkpoints/` | 예시
_Example| 설명
_Description| |---|---| | `sd_xl_refiner_1.0.safetensors` | SDXL Refiner 공식 모델
_{SDXL Refiner official model}| > Refiner는 CKPT / Separate 방식 모두에서 항상 선택 가능합니다. > The Refiner can always be configured regardless of CKPT or Separate loading mode. #### ESRGAN Upscale (Upscale 모드 필수) → `models/upscale_models/` #### ESRGAN Upscale (required for Upscale mode) → `models/upscale_models/` | 예시
_Example| 설명
_Description| |---|---| | `4x-UltraSharp.pth` | 고품질 4x 업스케일 모델 (권장)
_{high-quality 4x upscale model (recommended)}| | `4x_NMKD-Superscale-SP_178000_G.pth` | 범용 4x 업스케일 모델
_{general-purpose 4x upscale model}| --- ### 3-6. SeedVR2 Upscale 모델 (전체 노드 공용) ### 3-6. SeedVR2 Upscale model (shared by all nodes) 모든 노드의 **UPSCALE 모드**에서 동일한 폴더를 사용합니다. Node **UPSCALE Mode**to use. #### → `models/SEEDVR2/` | 파일명
_File| 설명
_Description| 다운로드
_Download| | --------------------------------------- | ------------------- | ------------------------------------------------------------ | | `seedvr2_ema_3b_fp16.safetensors` | DiT 3B FP16 | [SeedVR2-models](https://huggingface.co/numz/SeedVR2_comfyUI/tree/main) | | `seedvr2_ema_3b_fp8_e4m3fn.safetensors` | DiT 3B FP8 (저VRAM)
_{DiT 3B FP8 (VRAM)}| [SeedVR2-models](https://huggingface.co/numz/SeedVR2_comfyUI/tree/main) | | `seedvr2_ema_7b_fp8_e4m3fn.safetensors` | DiT 7B FP8 (고품질)
_{DiT 7B FP8 (high quality)}| [SeedVR2-models](https://huggingface.co/numz/SeedVR2_comfyUI/tree/main) | | `ema_vae_fp16.safetensors` | VAE FP16 | [SeedVR2-models](https://huggingface.co/numz/SeedVR2_comfyUI/tree/main) | > DiT 모델과 VAE 모델 **둘 다** 필요합니다. > DiT model VAE model **both** are required. > Upscale 모드 → **↻ Refresh** 버튼으로 모델 목록을 새로 고칩니다. > Upscale Mode → **↻ Refresh** button refreshes the model list. --- ## 4. 초기 설정 ## 4. Initial Setup ComfyUI 캔버스에서 노드 우상단 **⚙** 버튼을 눌러 Settings를 엽니다. ComfyUI on the ComfyUI canvas, click the **⚙** button at the top-right of the node to open Settings. | 항목
_Item| 설명
_Description| | -------------------- | --------------------------------------------- | | **Diffusion Model** | 다운로드한 UNet/DiT 파일 선택
_{select the downloaded UNet/DiT file}| | **Text Encoder** | 텍스트 인코더 파일 선택
_{select the text encoder file}| | **VAE** | VAE 파일 선택
_{select the VAE file}| | **↻ Refresh Models** | ComfyUI 재시작 없이 새 모델 파일 인식
_{ComfyUI when recognize new model files}| | **언어 / Language**
_{** / Language**}| 한국어 / English 전환 (선택 후 자동 새로고침)
_{Korean / English before (automatically refreshes after selection)}| | **Negative Prompt** | 전 모드 공통 부정 프롬프트
_{negative prompt shared by all modes}| | **Prompt Suffix** | 모든 프롬프트 끝에 자동 추가 키워드
_{keywords automatically appended to all prompts}| | **Save Subfolder** | `ComfyUI/output/` 하위 저장 폴더명
_{`ComfyUI/output/` output subfolder name}| | **💾 Save All** | 서버에 설정 영구 저장
_{save settings permanently on the server}| 설정은 **브라우저 로컬스토리지에 자동 저장**되어 재시작 후에도 유지됩니다. Settings are **automatically saved in browser local storage**and remain available after restarting. ### 모델 오버라이드 슬롯 (고급) ### Model Override Slots (Advanced) Settings → **Model Override** 체크박스를 켜면 노드에 입력 슬롯이 노출됩니다. Settings → **Model Override** enable the checkbox to expose input slots on the node. `Primitive (String)` 노드를 연결해 파일명을 입력하면 드롭다운보다 우선 적용됩니다. `Primitive (String)` connect a Primitive (String) node and enter a filename to override the dropdown. `.gguf` 파일명 입력 시 자동으로 GGUF 로더를 사용합니다. `.gguf` entering a .gguf filename automatically uses the GGUF loader. --- ## 5. 모드별 간략 설명 ## 5. Mode Overview ### Z-Image ONE STUDIO (TJ) | 모드
_Mode| 설명
_Description| 주요 설정
_{Key Settings}| | --------------- | ------------------------ | ------------------------------------------------------------ | | **T2I** | 텍스트 → 이미지
_{→ image}| 해상도 프리셋, Steps, CFG, Shift, Sampler, LoRA (최대 3개)
_{resolution preset, Steps, CFG, Shift, Sampler, LoRA ( 3)}| | **I2I** | 이미지 → 이미지 변형
_{image → image}| 소스 이미지 업로드, Denoise (0.5~1.0)
_{upload source image, Denoise (0.5~1.0)}| | **INPAINT** | 특정 영역 재생성
_{regenerate selected area}| 소스 이미지 → 캔버스에서 마스크 드로잉 (DifferentialDiffusion)
_{source image → draw a mask on the canvas (DifferentialDiffusion)}| | **OUTPAINT** | 캔버스 확장
_{canvas expansion}| Up/Down/Left/Right 픽셀 설정 → 빈 영역 자동 생성
_{Up/Down/Left/Right pixel settings → automatically generate empty areas}| | **RE-BG** | 배경 완전 재생성
_{completely regenerate the background}| BiRefNet으로 피사체 분리 → 새 배경 생성 후 합성
_{BiRefNet separate the subject → generate a new background and composite it}| | **CONTROLNET** | 레퍼런스 기반 생성
_{reference-based generation}| 레퍼런스 이미지 → Preprocessor 선택 → Strength 조절
_{reference image → Preprocessor selection → Strength adjustment}| | **FACE REDRAW** | 얼굴 자동 감지 후 재생성
_{automatically detect and regenerate the face}| YOLOv8/v9 감지 → LoRA 적용 재생성 → 원본에 자연 블렌드
_{YOLOv8/v9 detection → LoRA regenerate with LoRA → blend naturally into the original}| | **UPSCALE** | SeedVR2 AI 업스케일
_{SeedVR2 AI}| DiT 모델 + VAE 선택 → Resolution / Attention Mode 설정
_{DiT model + VAE selection → Resolution / Attention Mode settings}| ### Flux.2 Klein ONE STUDIO (TJ) | 모드
_Mode| 설명
_Description| 주요 설정
_{Key Settings}| | ------------ | --------------------------- | ------------------------------------------------------------ | | **T2I** | 텍스트 → 이미지
_{→ image}| 해상도, Steps(권장 4), CFG(권장 1), Sampler(euler_sde), LoRA (최대 3개)
_{resolution, Steps(recommended 4), CFG(recommended 1), Sampler(euler_sde), LoRA ( 3)}| | **I2I** | 이미지 → 이미지 변형
_{image → image}| Denoise 0.5~0.75(형태 유지) / 0.8~1.0(대폭 변형)
_{Denoise 0.5~0.75(preserve structure) / 0.8~1.0(major transformation)}| | **EDIT** | 멀티 레퍼런스 편집
_{multi-reference editing}| 참조 이미지 1~5장, Size Source (이미지1 기준 출력 크기)
_{reference images 1~5, Size Source (output size based on Image 1)}| | **PAINT** | 특정 영역 재생성 + Outpaint
_{regenerate selected area + Outpaint}| 캔버스 마스크 드로잉, 아웃페인트 방향/크기 설정
_{draw a canvas mask, set Outpaint direction and size}| | **FACESWAP** | 얼굴 교체 재생성
_{face replacement and regeneration}| Source(얼굴 공여자) + Target(원본) 업로드, BFS LoRA 강도 조절
_{Source(face donor) + Target(original) upload, BFS LoRA adjust strength}| | **UPSCALE** | SeedVR2 AI 업스케일
_{SeedVR2 AI}| DiT 모델 + VAE 선택
_{DiT model + VAE selection}| ### Qwen Image Edit 2511 ONE STUDIO (TJ) | 모드
_Mode| 설명
_Description| 주요 설정
_{Key Settings}| | ------------ | ------------------------- | ------------------------------------------------------------ | | **T2I** | 텍스트 → 이미지
_{→ image}| 해상도, Steps, CFG, Sampler, LoRA (최대 3개), Lightning LoRA (⚙ Settings)
_{resolution, Steps, CFG, Sampler, LoRA ( 3), Lightning LoRA (⚙ Settings)}| | **I2I** | 이미지 → 이미지 변형
_{image → image}| 소스 이미지, Denoise 조절
_{source image, Denoise adjustment}| | **EDIT** | 멀티 레퍼런스 텍스트 편집
_{multi-reference text editing}| 참조 이미지 최대 3장, Outpaint 포함
_{up to three reference images, Outpaint included}| | **PAINT** | 특정 영역 재생성
_{regenerate selected area}| ComfyUI 내장 마스크 에디터, Denoise 0.7~0.9 권장
_{ComfyUI built-in mask editor, Denoise 0.7~0.9 recommended}| | **FACESWAP** | 얼굴 교체
_{face replacement}| Target + Source 이미지, BFS LoRA 필수
_{Target + Source image, BFS LoRA required}| | **ANGLE** | 카메라 앵글 3D 조절
_{3D camera-angle control}| H(방위각) · V(고도각) · Z(줌) 드래그 조절, Camera Angle LoRA (⚙ Settings)
_{H(azimuth) · V(elevation) · Z(zoom) drag control, Camera Angle LoRA (⚙ Settings)}| | **UPSCALE** | SeedVR2 AI 업스케일
_{SeedVR2 AI}| DiT 모델 + VAE 선택
_{DiT model + VAE selection}| ### Krea 2 ONE STUDIO (TJ) | 모드
_Mode| 설명
_Description| 주요 설정
_{Key Settings}| | ----------- | -------------------- | ------------------------------------------------------------ | | **T2I** | 텍스트 → 이미지
_{→ image}| 해상도, Steps, CFG, Sampler, LoRA (최대 3개), Lightning LoRA (⚙ Settings)
_{resolution, Steps, CFG, Sampler, LoRA ( 3), Lightning LoRA (⚙ Settings)}| | **I2I** | 이미지 → 이미지 변형
_{image → image}| 소스 이미지, Denoise 조절
_{source image, Denoise adjustment}| | **UPSCALE** | SeedVR2 AI 업스케일
_{SeedVR2 AI}| DiT 모델 + VAE 선택
_{DiT model + VAE selection}| ### SDXL ONE STUDIO (TJ) 🧪 > 🧪 테스트 버전 — 기능 동작 중이나 일부 옵션이 변경될 수 있습니다. > 🧪 Test Version — functional but some options may change. | 모드
_Mode| 설명
_Description| 주요 설정
_{Key Settings}| | ----------- | -------------------- | ------------------------------------------------------------ | | **T2I** | 텍스트 → 이미지
_{text → image}| CKPT 또는 Separate(UNET+CLIP-L/G+VAE) 선택, 해상도, Steps, CFG, Sampler, Refiner
_{CKPT or Separate(UNET+CLIP-L/G+VAE), resolution, Steps, CFG, Sampler, Refiner}| | **I2I** | 이미지 → 이미지 변형
_{image → image}| 소스 이미지, Denoise 조절
_{source image, Denoise adjustment}| | **INPAINT** | 특정 영역 재생성
_{regenerate selected area}| 팝업 풀스크린 마스크 에디터 (줌·팬·브러시), VAEEncodeForInpaint 방식
_{popup fullscreen mask editor (zoom · pan · brush), VAEEncodeForInpaint method}| | **OUTPAINT** | 캔버스 확장
_{canvas expansion}| Top/Bottom/Left/Right 픽셀 설정, 비교 슬라이더에서 패딩 미리보기
_{Top/Bottom/Left/Right pixel settings, padded preview in compare slider}| | **UPSCALE** | ESRGAN + Refiner 업스케일
_{ESRGAN + Refiner upscale}| ESRGAN 모델 선택 (`models/upscale_models/`), Refiner KSampler 정제
_{ESRGAN model selection (`models/upscale_models/`), Refiner KSampler refinement}| --- ## 공통 기능 ## Common Features | 기능
_Feature| 설명
_Description| | ----------------- | ------------------------------------------------------------ | | **⇌ Compare** | 드래그 슬라이더로 원본 / 결과 나란히 비교
_{original / result}| | **🖼 Gallery** | 저장된 이미지 정사각형 그리드 보기. 즐겨찾기(★) · 삭제 · Send to
_{save image square grid view. favorite(★) · delete · Send to}| | **📋 Templates** | 자주 쓰는 프롬프트 저장 · 불러오기
_{save · load}| | **🔍 Prompt Edit** | 확장 편집 팝업. TJ_NODE 설치 시 ✨ Enhance · 🖼 Image→Prompt 탭 자동 활성화 (GGUF 모델 필요)
_{. TJ_NODE Installation when ✨ Enhance · 🖼 Image→Prompt Tab automatic (GGUF model required)}| | **Scroll Zoom** | 결과 이미지 위 마우스 스크롤 확대/축소
_{result image zoom/out}| | **Double Click** | 결과 이미지 더블클릭 → 전체화면 뷰어
_{result image click → All}| | **Send to** | 결과를 다른 모드의 소스로 즉시 전달
_{result Mode source when send}| | **Language** | Settings에서 한국어 / English 전환
_{Settingsto Korean / English before}| | **ESC** | 열린 팝업 / 갤러리 / 전체화면 닫기
_{/ Gallery / All close}| ### LLM 모델 안내 (Enhance · Image→Prompt) ### LLM model (Enhance · Image→Prompt) LLM 기능은 **GGUF 형식** 모델만 지원합니다. 일부 모델은 호환되지 않을 수 있으므로 동작하지 않으면 다른 모델로 교체해 보세요. LLM The feature **GGUF ** model supports. Some models may be incompatible; try another model if it does not work.. **✨ Enhance** — 텍스트 LLM GGUF 사용: **✨ Enhance** — uses a text LLM GGUF: | 추천
_Recommended| 다운로드
_Download| |---|---| | huihui-ai GGUF 컬렉션 (Qwen · Llama · Mistral 계열)
_{huihui-ai GGUF collection (Qwen · Llama · Mistral family)}| [noctrex/huihui-ai 컬렉션](https://huggingface.co/collections/noctrex/huihui-ai)
_{[noctrex/huihui-ai collection](https://huggingface.co/collections/noctrex/huihui-ai)}| **🖼 Image→Prompt** — 비전 LLM(VLM) GGUF + mmproj 파일 필요. **Qwen3-VL 계열 권장**: **🖼 Image→Prompt** — vision LLM(VLM) GGUF + mmproj file required. **Qwen3-VL family recommended**: | 추천
_Recommended| 다운로드
_Download| |---|---| | Qwen3-VL-8B-NSFW-Caption-V4.5 GGUF | [mradermacher GGUF](https://huggingface.co/mradermacher/Qwen3-VL-8B-NSFW-Caption-V4.5-GGUF) | | huihui-ai Qwen3-VL 계열 GGUF
_{huihui-ai Qwen3-VL family GGUF}| [noctrex/huihui-ai 컬렉션](https://huggingface.co/collections/noctrex/huihui-ai)
_{[noctrex/huihui-ai collection](https://huggingface.co/collections/noctrex/huihui-ai)}| > 모델 파일(`.gguf`)과 mmproj 파일을 함께 다운로드한 뒤 TJ_NODE GGUF 모델 폴더에 넣고, LLM 설정 패널에서 각각 선택하세요. > model file(`.gguf`) mmproj File download together, then TJ_NODE GGUF place them in the TJ_NODE GGUF model folder and, LLM select each file in the LLM settings panel. --- ## 6. 문제 해결 ## 6. Troubleshooting | 증상
_Symptom| 해결 방법
_Solution| | -------------------------------------- | ------------------------------------------------------------ | | 모델이 드롭다운에 안 보임
_{model not shown in the dropdown}| Settings → ↻ **Refresh Models** 클릭
_{Settings → ↻ **Refresh Models** click}| | SEEDVR2 모델 목록 안 나옴
_{SEEDVR2 model list is empty}| Upscale 모드 → **↻ Refresh** 클릭 · `models/SEEDVR2/` 폴더 확인
_{Upscale Mode → **↻ Refresh** click · `models/SEEDVR2/` check the folder}| | Outpaint 생성 시 완전히 새 이미지 생성
_{Outpaint generates a completely new image during Outpaint}| ComfyUI-KJNodes 최신 버전 설치 확인 (`ImagePadKJ` 노드 필요)
_{ComfyUI-KJNodes make sure the latest version is installed (`ImagePadKJ` node required)}| | Face Redraw 오류
_{Face Redraw error}| ComfyUI-Impact-Pack + ComfyUI-Impact-Subpack 설치 확인
_{ComfyUI-Impact-Pack + ComfyUI-Impact-Subpack verify installation}| | KV Cache 오류 (Klein)
_{KV Cache error (Klein)}| 파일명에 `kv` 미포함 시 자동 비활성화 — KV 모델 파일명 확인
_{Models whose filenames contain `kv` automatically disabled when the filename does not contain kv — KV check the KV model filename}| | GGUF 모델 안 로딩
_{GGUF model does not load}| ComfyUI-GGUF 커스텀 노드 설치 확인
_{ComfyUI-GGUF Custom Node verify installation}| | Faceswap 얼굴 미감지
_{Faceswap face is not detected}| ComfyUI_FaceAnalysis 설치 + `insightface` pip 설치 확인
_{ComfyUI_FaceAnalysis Installation + `insightface` pip verify installation}| | RE-BG 오류
_{RE-BG error}| ComfyUI-RMBG 설치 + `models/background_removal/` 모델 확인
_{ComfyUI-RMBG Installation + `models/background_removal/` model check}| | QE2511 FluxKontext 노드 미발견 오류
_{QE2511 FluxKontext Node missing-node error}| ComfyUI-KJNodes 최신 버전으로 업데이트
_{ComfyUI-KJNodes update to the latest version}| | 언어 전환 후 반영 안 됨
_{language change is not applied}| Settings에서 언어 선택 후 자동 새로고침 대기
_{Settingsto automatically refreshes after selection}| --- ## 폴더 구조 ## Folder Structure ``` ComfyUI/ ├── custom_nodes/ │ └── ComfyUI-TJ_NODE_STUDIO_ONE/ ← 이 패키지 │ └── models/ ├── diffusion_models/ ← UNet / DiT 메인 모델 (전체 노드) ├── text_encoders/ ← CLIP / Qwen / Gemma / Krea2 인코더 ├── vae/ ← VAE (전체 노드) ├── loras/ ← LoRA (Faceswap BFS, Lightning, Angle 포함) ├── controlnet/ ← ControlNet Union (Z-Image) ├── ultralytics/ │ └── bbox/ ← face_yolov8m.pt 등 (Z-Image Face Redraw) ├── background_removal/ ← BiRefNet 모델 (Z-Image RE-BG) └── SEEDVR2/ ← SeedVR2 DiT + VAE (전체 노드 Upscale) ``` --- ## 감사의 말 (Acknowledgements) ## Acknowledgements (Acknowledgements) 이 패키지의 핵심 아이디어와 기본 구조는 **[yanokusnir-ai](https://github.com/yanokusnir-ai)** 님의 오픈소스 프로젝트에서 영감을 받아 탄생했습니다. The core idea and basic structure of this package were inspired by **[yanokusnir-ai](https://github.com/yanokusnir-ai)** open-source project.. > **[one-node-flux-2-klein](https://github.com/yanokusnir-ai/one-node-flux-2-klein)** > — 단일 노드에서 Flux.2 Klein을 올인원으로 다루는 핵심 아이디어의 원작 > — the original project behind the core idea of handling Flux.2 Klein as an all-in-one solution within a single node TJ NODE STUDIO ONE 패밀리(Z-Image · Klein · QE2511 · Krea2)는 이 아이디어를 기반으로 다중 모델·다중 모드로 확장한 파생 작업입니다. TJ NODE STUDIO ONE family(Z-Image · Klein · QE2511 · Krea2) is a derivative work that expands this idea to multiple models and multiple modes. 원작자의 기여와 오픈소스 정신에 진심으로 감사드립니다. 🙏 We sincerely thank the original author for their contribution and open-source spirit.. 🙏 Some TJ_NODE systems were rebuilt and extended based on concepts inspired by: - TooBusy Nodes - 너무바쁜베짱이 - TooBusy Nodes - TooBusy Grasshopper https://github.com/designloves2/toobusy
https://www.youtube.com/@%EB%84%88%EB%AC%B4%EB%B0%94%EC%81%9C%EB%B2%A0%EC%A7%B1%EC%9D%B4
- comfyui-deno-custom-nodes https://github.com/Deno2026/comfyui-deno-custom-nodes
https://www.youtube.com/@Denoise-AI
- RebelsPromptEnhancer node https://github.com/designloves2/RebelsPromptEnhancer
https://www.youtube.com/@realrebelai
Several nodes were heavily reworked and integrated into the TJ wireless workflow architecture. ### Krea2 ControlNet - [Krea-2-controlnet](https://github.com/Tanmaypatil123/Krea-2-controlnet) — Thanks to Tanmaypatil123 for documenting the reference Krea2 control-LoRA inference pipeline. - [Patil/Krea-2-depth-controlnet](https://huggingface.co/Patil/Krea-2-depth-controlnet) — Thanks for providing the public depth Control LoRA weights. - [facok/comfyui-krea2-controlnet](https://github.com/facok/comfyui-krea2-controlnet) — Thanks for the ComfyUI Krea2 Control LoRA node implementation used in this project. --- ## 라이선스 ## License *MIT License · [TJ NODE STUDIO ONE](https://github.com/designloves2/ComfyUI-TJ_NODE_STUDIO_ONE)*

Flux.2 Klein ONE STUDIO (TJ)

Inputs (1)

Outputs (1)