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 RUNinstead 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

포함 노드
Included Nodes
설치 방법
Installation
필수 커스텀 노드
Required Custom Nodes
Z-Image ONE STUDIO — 기능 상세
Z-Image ONE STUDIO — Feature Details
Flux.2 Klein ONE STUDIO — 기능 상세
Flux.2 Klein ONE STUDIO — Feature Details
Qwen Image Edit 2511 ONE STUDIO — 기능 상세
Qwen Image Edit 2511 ONE STUDIO — Feature Details
Krea 2 ONE STUDIO — 기능 상세
Krea 2 ONE STUDIO — Feature Details
SDXL ONE STUDIO — 기능 상세 🧪
SDXL ONE STUDIO — Feature Details 🧪
공통 기능
Common Features
버그 수정 이력
Bug Fix History
라이선스
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

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:

chmod +x install_requirements.sh
./install_requirements.sh

이미 설치된 노드는 자동으로 건너뜁니다
Already installed nodes are skipped automatically
requirements.txt가 있는 노드는 pip install까지 자동 처리
requirements.txtNodes 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	FaceDetailer — 얼굴 감지·재생성·블렌드 핵심 엔진 _{FaceDetailer — core engine for face detection, regeneration, and blending}	Z-Image Face Redraw
ComfyUI-Impact-Subpack	Impact Pack 필수 서브팩 (함께 설치 필요) _{Impact Pack required subpack (must be installed together)}	Z-Image Face Redraw
ComfyUI-KJNodes	FluxKVCache · ImagePadKJ · FluxKontext 관련 노드 _{FluxKVCache · ImagePadKJ · FluxKontext related nodes}	Klein · QE2511
ComfyUI-GGUF	GGUF 형식 모델 로딩 _{GGUF format model loading}	선택 (GGUF 사용 시) _{selection (GGUF when used)}
ComfyUI_FaceAnalysis	Faceswap 모드 얼굴 감지 _{Faceswap mode face detection}	Klein · QE2511 Faceswap
ComfyUI-RMBG	배경 제거 _{background removal}	Z-Image RE-BG
comfyui_controlnet_aux	ControlNet 전처리기 (depth/canny) _{ControlNet preprocessor (depth/canny)}	Z-Image ControlNet · Krea2 ControlNet 🧪
ComfyUI-SeedVR2	SeedVR2 AI 업스케일 노드 _{SeedVR2 AI upscaling node}	전체 노드 Upscale 모드 _{Upscale mode for all nodes}
comfyui-krea2-controlnet 🧪	Krea2 Control LoRA (depth) _{Krea2 Control LoRA (depth)}	Krea2 ControlNet Depth
comfyui-krea2edit 🧪	Krea2 in-context 편집 _{Krea2 in-context edit}	Krea2 IDENTITY
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
Text Encoder	`models/text_encoders/`	qwen_3_4b
VAE	`models/vae/`	ae.safetensors
ControlNet (선택) _{ControlNet (selection)}	`models/controlnet/`	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
Text Encoder (9B)	`models/text_encoders/`	Comfy-Org 9B pack
Text Encoder (4B)	`models/text_encoders/`	Comfy-Org 4B pack
VAE	`models/vae/`	Comfy-Org 9B pack
BFS LoRA (Faceswap)	`models/loras/`	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
Text Encoder	`models/text_encoders/`	Comfy-Org QE2511
VAE	`models/vae/`	Comfy-Org QE2511
Lightning LoRA (선택) _{Lightning LoRA (selection)}	`models/loras/`	Qwen-Image-Edit-2511-Lightning
Camera Angle LoRA (선택) _{Camera Angle LoRA (selection)}	`models/loras/`	Multi Angle LoRa
BFS LoRA (Faceswap 필수) _{BFS LoRA (Faceswap required)}	`models/loras/`	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
Text Encoder	`models/text_encoders/`	Comfy-Org Krea2
VAE	`models/vae/`	Comfy-Org Krea2

🧪 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	IDENTITY (`Krea2EditModelPatch` · `Krea2EditGroundedEncode`)
comfyui-krea2-controlnet	ControlNet Depth (`Krea2ControlLoRALoader` · `…ImageEncode` · `…Apply`)
ComfyUI-NK2E	ControlNet Canny (`NK2EInContextEditNode`)
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
Depth ControlNet	depth control LoRA (예: `depth-control-lora.safetensors`)	Patil/Krea-2-depth-controlnet
Canny ControlNet	NK2E canny LoRA (예: `NK2E-canny-v0.1.safetensors`)	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)

위 커스텀 노드 설치 후 ComfyUI 재시작 / install the nodes above, restart ComfyUI
LoRA 파일을 models/loras/ 에 배치 / place the LoRA files in models/loras/
⚙ Settings 에서 IDENTITY LoRA, Depth/Canny Control LoRA 파일만 등록 / register only the LoRA files in Settings
조절값(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

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

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 : vchanged 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: ImagePadKJchanged 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: GetImageSizeGetImageSize read the original image before padding, causing EmptyFlux2LatentImageand VAEEncodeto 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) → FluxKontextMultiReferenceLatentMethodconnected 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 — 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 nodesprompt 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 automaticallyso 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 overlayvisually 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

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.

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

설치: 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

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:

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
ComfyUI-Impact-Subpack	Impact Pack 의존 서브팩 _{Impact Pack dependency subpack}	Z-Image · Face Redraw	ltdrdata/ComfyUI-Impact-Subpack
ComfyUI-KJNodes	FluxKVCache · ImagePadKJ · FluxKontext 노드 포함 _{FluxKVCache · ImagePadKJ · FluxKontext Node included}	Klein · QE2511	kijai/ComfyUI-KJNodes
ComfyUI-GGUF	GGUF 양자화 모델 로딩 _{GGUF model}	선택 (GGUF 사용 시) _{selection (GGUF when used)}	city96/ComfyUI-GGUF
ComfyUI_FaceAnalysis	Faceswap 얼굴 임베딩 분석 _{Faceswap face embedding analysis}	Klein · QE2511 Faceswap	cubiq/ComfyUI_FaceAnalysis
ComfyUI-RMBG	배경 제거 (RE-BG 모드) _{background removal (RE-BG Mode)}	Z-Image · RE-BG	1038lab/ComfyUI-RMBG
comfyui_controlnet_aux	ControlNet 전처리기 (Depth · Canny · Pose 등) _{ControlNet preprocessor (Depth · Canny · Pose etc.)}	Z-Image · ControlNet	Fannovel16/comfyui_controlnet_aux
ComfyUI-SeedVR2	SeedVR2 AI 업스케일 (UPSCALE 모드) _{SeedVR2 AI (UPSCALE Mode)}	전체 노드 _{All Node}	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}	다운로드 _Download

전체 모델 목록: 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`	다운로드 _Download

VAE → `models/vae/`

파일명 _File	다운로드 _Download
`ae.safetensors`	다운로드 _Download

ControlNet → `models/controlnet/` (ControlNet 모드 사용 시)

ControlNet → `models/controlnet/` (ControlNet Mode when used)

파일명 _File	다운로드 _Download
`Z-Image-Turbo-Fun-Controlnet-Union.safetensors`	다운로드 _Download

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}	다운로드 _Download
`face_yolov9c.pt`	다운로드 _Download

BG Removal → `models/background_removal/` (RE-BG 모드 사용 시)

BG Removal → `models/background_removal/` (RE-BG Mode when used)

다운로드 _Download
Comfy-Org/BiRefNet — 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
`flux2-klein-4b.safetensors`	FLUX.2 Klein 4B (경량) _{FLUX.2 Klein 4B (lightweight)}	Black Forest Labs Collection

⚠ 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
4B 모델용 _{4B for the model}	Comfy-Org 4B — split_files/text_encoders

VAE → `models/vae/`

다운로드 _Download
Comfy-Org 9B — 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`	다운로드 _Download
`bfs_head_v1_flux-klein_4b.safetensors`	다운로드 _Download

BG Removal → `models/background_removal/` (Edit·Paint 마스크 사용 시)

BG Removal → `models/background_removal/` (Edit·Paint when used)

다운로드 _Download
Comfy-Org/BiRefNet — 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 목록 _{HF list}
GGUF 경량 버전 _{GGUF lightweight version}	저VRAM 환경 _{low-VRAM environment}	HF 목록 _{HF list}

Text Encoder (CLIPLoader qwen_image) → `models/text_encoders/`

파일명 _File	다운로드 _Download
`qwen2.5vl-7b-vis-encoder.safetensors`	HF 목록 _{HF list}

VAE → `models/vae/`

파일명 _File	다운로드 _Download
`ae.safetensors`	HF 목록 _{HF list}

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 목록 _{HF list}

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 목록 _{HF list}

BFS LoRA → `models/loras/` (Faceswap 모드 필수)

BFS LoRA → `models/loras/` (Faceswap Mode required)

다운로드 _Download
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 목록 _{HF list}

Text Encoder (CLIP krea2) → `models/text_encoders/`

다운로드 _Download
HF 목록 _{HF list}

VAE → `models/vae/`

다운로드 _Download
HF 목록 _{HF list}

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 Modeto use.

→ `models/SEEDVR2/`

파일명 _File	설명 _Description	다운로드 _Download
`seedvr2_ema_3b_fp16.safetensors`	DiT 3B FP16	SeedVR2-models
`seedvr2_ema_3b_fp8_e4m3fn.safetensors`	DiT 3B FP8 (저VRAM) _{DiT 3B FP8 (VRAM)}	SeedVR2-models
`seedvr2_ema_7b_fp8_e4m3fn.safetensors`	DiT 7B FP8 (고품질) _{DiT 7B FP8 (high quality)}	SeedVR2-models
`ema_vae_fp16.safetensors`	VAE FP16	SeedVR2-models

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 storageand 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.51.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.50.75(preserve structure) / 0.81.0(major transformation)}
EDIT	멀티 레퍼런스 편집 _{multi-reference editing}	참조 이미지 15장, 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.70.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 컬렉션 _{noctrex/huihui-ai collection}

🖼 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
huihui-ai Qwen3-VL 계열 GGUF _{huihui-ai Qwen3-VL family GGUF}	noctrex/huihui-ai 컬렉션 _{noctrex/huihui-ai collection}

모델 파일(.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 님의 오픈소스 프로젝트에서 영감을 받아 탄생했습니다. The core idea and basic structure of this package were inspired by yanokusnir-ai open-source project..

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 — Thanks to Tanmaypatil123 for documenting the reference Krea2 control-LoRA inference pipeline.
Patil/Krea-2-depth-controlnet — Thanks for providing the public depth Control LoRA weights.
facok/comfyui-krea2-controlnet — Thanks for the ComfyUI Krea2 Control LoRA node implementation used in this project.

라이선스

License

MIT License · TJ NODE STUDIO ONE

Name		Name	Last commit message	Last commit date
Latest commit History 40 Commits
.github/workflows		.github/workflows
ComfyUI_workflows_sample		ComfyUI_workflows_sample
web		web
workflows		workflows
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
PROMO.md		PROMO.md
README.md		README.md
SETUP_GUIDE.md		SETUP_GUIDE.md
__init__.py		__init__.py
config_klein.json		config_klein.json
config_krea2.json		config_krea2.json
config_qwen2511.json		config_qwen2511.json
config_sdxl_one.json		config_sdxl_one.json
config_zimage.json		config_zimage.json
favorites_klein.json		favorites_klein.json
favorites_krea2.json		favorites_krea2.json
favorites_zimage.json		favorites_zimage.json
install_requirements.bat		install_requirements.bat
install_requirements.sh		install_requirements.sh
nodes.py		nodes.py
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt

Folders and files

Latest commit

History

Repository files navigation

TJ NODE STUDIO ONE (통합 패키지)

TJ NODE STUDIO ONE (Integrated Package)

목차

Table of Contents

포함 노드

Included Nodes

설치 방법

Installation

ComfyUI Manager (권장)

ComfyUI Manager (recommended)

수동 설치

Manual Installation

필수 커스텀 노드

Required Custom Nodes

⚡ 자동 설치 (권장)

⚡ Automatic Installation (recommended)

수동 설치 목록

Manual Installation List

Z-Image ONE STUDIO — 기능 상세

Z-Image ONE STUDIO — Feature Details

지원 모드

Supported Modes

필수 모델

Required Models

Flux.2 Klein ONE STUDIO — 기능 상세

Flux.2 Klein ONE STUDIO — Feature Details

지원 모드

Supported Modes

필수 모델

Required Models

Qwen Image Edit 2511 ONE STUDIO — 기능 상세

Qwen Image Edit 2511 ONE STUDIO — Feature Details

지원 모드

Supported Modes

필수 모델

Required Models

Krea 2 ONE STUDIO — 기능 상세

Krea 2 ONE STUDIO — Feature Details

지원 모드

Supported Modes

필수 모델

Required Models

🧪 IDENTITY · ControlNet (depth / canny) — 실험적 기능

🧪 IDENTITY · ControlNet (depth / canny) — Experimental Features

SDXL ONE STUDIO — 기능 상세 🧪

SDXL ONE STUDIO — Feature Details 🧪

지원 모드

Supported Modes

모델 로딩 방식

Model Loading Mode

주요 기능

Key Features

필수 모델

Required Models

공통 기능

Common Features

설정 패널 (⚙ Settings)

Settings Panel (⚙ Settings)

SeedVR2 Upscale 모델 (전체 노드 공용)

SeedVR2 Upscale model (shared by all nodes)

LoRA

갤러리 (🖼 Gallery)

Gallery (🖼 Gallery)

비교 슬라이더 (⇌ Compare)

Comparison Slider (⇌ Compare)

단축키

Keyboard Shortcuts

버그 수정 이력

Bug Fix History

v1.5.0 (현재)

v1.4.1

v1.4.1 (Current)

v1.2

v1.1

함께 쓰면 더 강력한 — TJ_NODE

More Powerful Together with — TJ_NODE

Diffusion Model → `models/diffusion_models/`

Text Encoder → `models/text_encoders/`

VAE → `models/vae/`

ControlNet → `models/controlnet/` (ControlNet 모드 사용 시)

ControlNet → `models/controlnet/` (ControlNet Mode when used)

Face Detector → `models/ultralytics/bbox/` (Face Redraw 모드 사용 시)

Face Detector → `models/ultralytics/bbox/` (Face Redraw Mode when used)

BG Removal → `models/background_removal/` (RE-BG 모드 사용 시)

BG Removal → `models/background_removal/` (RE-BG Mode when used)

Diffusion Model → `models/diffusion_models/`

Text Encoder → `models/text_encoders/`

VAE → `models/vae/`

Faceswap LoRA → `models/loras/` (Faceswap 모드 사용 시)

Faceswap LoRA → `models/loras/` (Faceswap Mode when used)

BG Removal → `models/background_removal/` (Edit·Paint 마스크 사용 시)

BG Removal → `models/background_removal/` (Edit·Paint when used)

Diffusion Model → `models/diffusion_models/`

Text Encoder (CLIPLoader qwen_image) → `models/text_encoders/`

VAE → `models/vae/`

Lightning LoRA → `models/loras/` (4스텝 고속 생성, 선택사항)

Lightning LoRA → `models/loras/` (4 fast generation, optional)

Multi Angle LoRA → `models/loras/` (Angle 모드 필수)

Multi Angle LoRA → `models/loras/` (Angle Mode required)

BFS LoRA → `models/loras/` (Faceswap 모드 필수)

BFS LoRA → `models/loras/` (Faceswap Mode required)

Diffusion Model → `models/diffusion_models/`

Text Encoder (CLIP krea2) → `models/text_encoders/`

VAE → `models/vae/`

Checkpoint → `models/checkpoints/` (CKPT 방식)

Checkpoint → `models/checkpoints/` (CKPT mode)

Separate 방식 — UNET → `models/diffusion_models/`

Separate Mode — UNET → `models/diffusion_models/`

Separate 방식 — Text Encoder → `models/text_encoders/`

Separate Mode — Text Encoder → `models/text_encoders/`