로컬 설치 가이드
ComfyUI에서 FLUX 3 Klein 실행하는 방법
FLUX 3 Klein은 오픈 웨이트와 ComfyUI 템플릿을 함께 제공하므로 API 키도, 이미지당 크레딧도 없이 내 GPU에서 돌릴 수 있습니다. 무엇을 설치하고 파일을 어디에 두는지, 기본 제공 workflow 4개가 어떻게 다른지, 라이선스가 무엇을 허용하는지 정리했습니다.
로컬 ComfyUI냐, 브라우저냐
로컬 ComfyUI는 전체 과정을 내 컴퓨터 안에 둡니다. 프롬프트와 참조 이미지, 출력 파일이 디스크를 벗어나지 않고 이미지당 비용도 없습니다. 대신 준비가 가장 번거롭습니다. 템플릿은 특정 ComfyUI 버전과 다섯 개의 파일, 작업별로 맞는 checkpoint를 전제로 합니다.
내 문장에 모델이 어떻게 반응하는지만 보고 싶다면 설치는 건너뛰어도 됩니다. 이 사이트는 자체 서버에서 FLUX 3 Klein을 돌리며 참조 이미지를 최대 3장까지 받습니다. 여기서 쓴 프롬프트는 1분 안에 결과가 돌아옵니다.
이 입력창은 이 사이트의 유일한 모델인 FLUX 3 Klein 생성기를 엽니다. 설치할 것도, 내려받을 파일도 없습니다.
시작하기 전에 준비할 것
템플릿은 버전, 파일, checkpoint의 특정 조합을 전제로 만들어졌습니다. 이 네 가지 중 하나라도 어긋나면 workflow가 로드되지 않거나 샘플링 중에 실패합니다.
ComfyUI 0.41.0 이상
FLUX 3 Klein 템플릿은 ComfyUI 0.41.0 이상이 필요하며 0.41.1 백포트로 배포되었습니다. 템플릿 목록에 없다면 먼저 ComfyUI를 업데이트하세요.
gated 웨이트 저장소 접근 권한
웨이트는 Hugging Face의 black-forest-labs/flux-3-image-klein-comfy에 있습니다. 로그인한 상태에서 저장소를 열고 라이선스에 동의해야 파일이 열립니다.
세 개 폴더에 다섯 개 파일
디퓨전 checkpoint 두 개, 텍스트 인코더, 프롬프트 확장기, FLUX.2 VAE를 models/diffusion_models/, models/text_encoders/, models/vae/에 넣습니다.
고른 checkpoint에 맞는 VRAM
ComfyUI 문서에는 VRAM 요구 사항이 없습니다. Black Forest Labs는 생성기 웨이트를 BF16 11.2 GB, FP8 5.6 GB로 제시하고, INT8 빌드는 NVIDIA RTX에서 최소 8 GB VRAM으로 돌아간다고 밝힙니다. 참조 코드의 1024x1024 피크는 이보다 높습니다. 자세한 수치는 FAQ에 있습니다.
웨이트 파일과 넣을 폴더
템플릿이 불러오는 것은 int8(convrot) 단일 파일 checkpoint입니다. 같은 저장소에 bf16과 nvfp4 빌드도 있습니다. 내려받은 파일을 아래 폴더에 넣으세요.
| 폴더 | 쓰이는 곳 | |
|---|---|---|
| flux3_image_klein_base_int8_convrot.safetensors | models/diffusion_models/ | FLUX 3 Klein 전체 checkpoint; 텍스트 생성과 이미지 편집 템플릿이 이 파일을 씁니다 |
| flux3_image_klein_sd_int8_convrot.safetensors | models/diffusion_models/ | 4~16 스텝 실행용 증류 checkpoint |
| qwen3vl_4b_int8_convrot.safetensors | models/text_encoders/ | 두 checkpoint가 함께 쓰는 텍스트 인코더; CLIPLoader에서 type을 flux3로 지정해 불러옵니다 |
| qwen3.5_9b_flux3_prompt_upsampler_w4a8.safetensors | models/text_encoders/ | 텍스트 생성 템플릿이 사용하는 프롬프트 확장기 |
| flux2-vae.safetensors | models/vae/ | FLUX 3 Klein용 VAE, 즉 FLUX.2 VAE |
경로는 ComfyUI 폴더 기준입니다. 저장소는 gated이므로 huggingface.co/black-forest-labs/flux-3-image-klein-comfy에서 먼저 라이선스에 동의해야 파일이 열립니다. 출처: docs.comfy.org/tutorials/flux/flux-3-klein, 2026년 10월 17일 확인.
workflow 4개 실행 순서
템플릿 라이브러리에는 FLUX 3 Klein workflow가 4개 있습니다. 텍스트 생성과 이미지 편집에 각각 정식판과 증류판이 있는 구성입니다.
텍스트 생성, 정식 checkpoint
"FLUX 3 Image Klein: Text to Image"를 열고 subgraph에 프롬프트를 입력한 뒤 가로·세로를 지정하거나 ResolutionSelector에서 프레임을 고르고, steps는 50, cfg는 3.5로 둡니다. Qwen3.5 9B 확장기는 기본으로 켜져 있으니 내 문장을 그대로 샘플링하려면 enable_prompt_upsampler를 끕니다.
텍스트 생성, 증류판
이 workflow는 flux3_image_klein_sd_int8_convrot.safetensors를 불러와 16 스텝, cfg 고정 1로 돌아갑니다. cfg를 올려도 효과가 없습니다. 빠르게 돌리려면 4 스텝까지 낮출 수 있습니다.
이미지 편집, 정식 checkpoint
LoadImage 노드에 원본 사진을 넣고 Set Reference Multi Latent에 연결합니다. 지시문은 완성된 이미지에 대한 완전한 설명으로 씁니다. 기본 예시 프롬프트는 "In <ref_image_0>, change the dress color <obj_1> to red"입니다. 캔버스는 Empty Flux 2 Latent(템플릿에서는 1024x1024)에서 오고, 여기서 guidance는 1입니다.
이미지 편집, 증류판
참조 이미지 하나, 지시문 하나, 16 스텝, guidance 없음. steps는 4에서 16 사이로 두고 cfg는 1로 유지한 뒤 ImageCompare에서 원본과 결과를 비교하세요.
결과를 바꾸는 프롬프트와 참조 이미지 요령
ComfyUI 문서에서 가져온 다섯 가지입니다. 어떤 샘플러 설정보다 결과를 크게 좌우합니다.
바꿀 것이 아니라 결과를 쓰세요
편집 템플릿은 수정이 반영된 완성 이미지의 완전한 설명을 기대합니다. 기본 예시가 "이걸 바꿔줘" 대신 새 색과 그 대상 객체를 설명하는 이유입니다.
ComfyUI의 참조 이미지는 0부터 시작
추가 이미지를 순서대로 Set Reference Multi Latent에 연결하고 <ref_image_0>, <ref_image_1>처럼 지정합니다. 차이를 기억하세요: ComfyUI 템플릿은 <ref_image_0>에서 시작하지만 이 사이트 생성기는 <ref_image_1>에서 시작하고 최대 3장까지 받습니다.
참조 이미지 크기는 비용 조절판
템플릿은 각 참조 이미지를 약 100만 픽셀로 줄이고 출력 latent도 그 크기를 따릅니다. 원본 크기를 유지하면 편집에 디테일이 더 들어가지만 비용이 커집니다.
스텝 수는 checkpoint를 따릅니다
정식 checkpoint는 텍스트 생성이 50 스텝·guidance 3.5, 편집 workflow가 guidance 1입니다. 증류판은 16 스텝에 guidance 고정 1입니다. 정식판 설정을 증류판에 옮겨 쓰지 마세요.
Create Bounding Boxes 노드가 들어 있습니다
영역 편집을 계획할 때 씁니다. 원본 이미지 위에 박스를 그리고 Preview Any가 목록을 보여줍니다.
라이선스가 말하는 것
공개한 쪽이 밝힌 요점만 게시된 그대로 인용합니다. 라이선스 해석이 아니며, 생성물을 판매할 계획이라면 원문을 읽으세요.
| 게시된 내용 | |
|---|---|
| FLUX 3 Klein 웨이트 | FLUX Kommunity License: 비상업적 사용에 더해 연 매출 500만 달러 미만인 Qualifying User의 상업적 출력 생성이 허용되며, 조건은 라이선스 조항을 따릅니다 |
| 텍스트 인코더(Qwen3-VL-4B-Instruct) | Apache-2.0 |
| 저장소 접근 | Hugging Face의 gated 저장소이며, 라이선스에 동의해야 파일이 열립니다 |
| 라이선스 전문 | 웨이트 저장소 안의 LICENSE.md(아래 링크) |
출처: bfl.ai/blog/flux-3-image-klein, huggingface.co/black-forest-labs/flux-3-image-klein-base, gated 웨이트 저장소의 LICENSE.md, 모두 2026년 10월 17일 확인. 공개된 조건만 옮긴 것이며 법률 자문이 아닙니다.
웨이트는 어디서 받나요
이 사이트는 자체 서버에서 FLUX 3 Klein을 돌리며 웨이트를 보관하거나 판매하지 않습니다. 여기서 내려받을 수 있는 파일은 없습니다. 파일은 Hugging Face에 있고 위 단계는 ComfyUI 문서에서 가져왔습니다.
FLUX 3 Klein 로컬 실행
FLUX 3 Klein에는 어떤 ComfyUI 버전이 필요한가요?
0.41.0 이상입니다. 템플릿은 0.41.1 백포트로 배포되었으므로 템플릿 목록에 "FLUX 3 Image Klein"이 없다면 ComfyUI를 업데이트한 뒤 다시 확인하세요.
이 사이트에서 FLUX 3 Klein 웨이트를 내려받을 수 있나요?
아니요. 이 사이트는 브라우저에서 모델을 실행할 뿐 파일을 보관하지 않습니다. 라이선스에 동의한 뒤 Hugging Face의 gated 저장소 black-forest-labs/flux-3-image-klein-comfy에서 받으세요.
FLUX 3 Klein에는 VRAM이 얼마나 필요한가요?
ComfyUI 문서에는 요구 사항이 없습니다. Black Forest Labs는 생성기 웨이트를 BF16 11.2 GB, FP8 5.6 GB로 제시하고 INT8 빌드는 RTX에서 8 GB VRAM으로 돌아간다고 밝힙니다. 참조 코드의 1024x1024 피크는 BF16 31 GB, FP8 29 GB, NVFP4 26 GB이며, 80 GB 카드에서는 확장기가 약 28 GB를 더 씁니다. 모두 제조사 자체 수치입니다.
workflow가 샘플링 전에 프롬프트를 바꾸는 이유는 무엇인가요?
텍스트 생성 템플릿이 기본으로 Qwen3.5 9B 프롬프트 확장기를 실행해 짧은 요청을 완전한 장면 설명으로 늘리기 때문입니다. 내 문장으로 샘플링하려면 enable_prompt_upsampler를 off로 두세요.
ComfyUI 템플릿과 이 사이트 생성기의 참조 번호가 같은가요?
다릅니다. ComfyUI는 <ref_image_0>에서, 이 사이트 생성기는 <ref_image_1>에서 시작합니다. 프롬프트를 옮길 때는 토큰을 고쳐 쓰세요.