black-forest-labs/flux-3-image-klein-comfy · Hugging Face

Source: https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#flux-3-image-klein-for-comfyuiFLUX 3 Image Klein for ComfyUI

FLUX 3 Image Klein is a 5.6B open weights model for text-to-image generation and image editing. It takes a prompt and up to 10 reference images and returns one image. Text-to-image, single-reference edits and multi-reference compositions run through the same model, with Qwen3-VL-4B-Instruct as the text encoder.

The 5.6B parameter label refers to the image transformer; the text encoder is separate.

This repository holds the model files repackaged forComfyUI: the distilled and base transformers in BF16, int8 and NVFP4, the text encoder in BF16 and int8, the prompt upsampler in int8, and the image autoencoder. The original model repositories areFLUX 3 Image Klein,FLUX 3 Image Klein BaseandFLUX 3 Image Klein Prompt Upsampler.

Inference code, prompt upsampling and the bounding box format:black-forest-labs/flux-3-image-kleinon GitHub.

**Do not use the model without a prompt upsampler.**FLUX 3 Image Klein takes full scene captions, for text-to-image, editing and layout with boxes alike; a short prompt sent as typed gives generic output. Use ours, theqwen3\.5\_9b\_flux3\_prompt\_upsampler\_int8\_convrot\.safetensorsfile in this repository withenable\_prompt\_upsampleron in the templates (seeUsing with ComfyUI), or any LLM you prefer with a system prompt that expands the request into one full scene caption (system\_prompts\.jsonhas ours).

CheckpointFormatStepsGuidanceBuilt forKlein Baseundistilled, bfloat16503.5fine-tuning, LoRA training, researchKleindistilled, bfloat1616nonegeneration and editing, self-hosting; the checkpoint behind the BFL API

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#key-featuresKey Features

1. Text-to-image, single-reference editing and multi-reference generation in one model.
2. Bounding boxes in the prompt. Place elements with boxes on a 0 to 1000 grid, then recolor, move, replace or remove them through the prompt. Boxes guide placement and scale; they do not constrain pixels to a hard mask.
3. Text rendering within generated images.
4. Released under theFLUX Kommunity License. The license permits non-commercial use and provides a commercial-output exception for Qualifying Users, subject to its terms. SeeLicensebelow.

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#filesFiles

Place the files in the following folders:

📂 ComfyUI/
└── 📂 models/
    ├── 📂 diffusion_models/
    │   ├── flux3_image_klein_bf16.safetensors
    │   ├── flux3_image_klein_int8_convrot.safetensors
    │   ├── flux3_image_klein_nvfp4.safetensors
    │   ├── flux3_image_klein_sd_bf16.safetensors
    │   ├── flux3_image_klein_sd_int8_convrot.safetensors
    │   └── flux3_image_klein_sd_nvfp4.safetensors
    ├── 📂 text_encoders/
    │   ├── qwen3.5_9b_flux3_prompt_upsampler_int8_convrot.safetensors
    │   ├── qwen3vl_4b_bf16.safetensors
    │   └── qwen3vl_4b_int8_convrot.safetensors
    └── 📂 vae/
        └── flux2-vae.safetensors

Files with\_sd\_in the name are the distilled checkpoint; the others are the base checkpoint.

FileContentSizediffusion\_models/flux3\_image\_klein\_sd\_bf16\.safetensorsKlein, distilled, BF1611.1 GBdiffusion\_models/flux3\_image\_klein\_sd\_int8\_convrot\.safetensorsKlein, distilled, int85.8 GBdiffusion\_models/flux3\_image\_klein\_sd\_nvfp4\.safetensorsKlein, distilled, NVFP45.3 GBdiffusion\_models/flux3\_image\_klein\_bf16\.safetensorsKlein Base, BF1611.1 GBdiffusion\_models/flux3\_image\_klein\_int8\_convrot\.safetensorsKlein Base, int85.8 GBdiffusion\_models/flux3\_image\_klein\_nvfp4\.safetensorsKlein Base, NVFP45.3 GBtext\_encoders/qwen3vl\_4b\_bf16\.safetensorsQwen3-VL-4B-Instruct text encoder, BF168.9 GBtext\_encoders/qwen3vl\_4b\_int8\_convrot\.safetensorsQwen3-VL-4B-Instruct text encoder, int84.9 GBtext\_encoders/qwen3\.5\_9b\_flux3\_prompt\_upsampler\_int8\_convrot\.safetensorsprompt upsampler, int89.8 GBvae/flux2\-vae\.safetensorsimage autoencoder0.3 GB The BF16 transformer and the autoencoder are the same files asmodel\.safetensorsandae\.safetensorson the original repositories. The int8 files run on 8 GB GPUs such as the RTX 3070, and on GPUs without FP8 support (RTX 30 series and older). NVFP4 needs a Blackwell GPU.

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#downloadDownload

One checkpoint, its text encoder and the autoencoder, straight into the ComfyUI model folders:

hf download black-forest-labs/flux-3-image-klein-comfy \
  diffusion_models/flux3_image_klein_sd_int8_convrot.safetensors \
  text_encoders/qwen3vl_4b_int8_convrot.safetensors \
  vae/flux2-vae.safetensors \
  text_encoders/qwen3.5_9b_flux3_prompt_upsampler_int8_convrot.safetensors \
  --local-dir ComfyUI/models

Swap the first two file names for the precision and checkpoint you want from the table above. The last file is the prompt upsampler, which rewrites a short request into the full scene caption before generation.

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#using-with-comfyuiUsing with ComfyUI

Download thedefault ComfyUI v0.41 workflowsfor base and distilled text-to-image generation and image editing.

Turnenable\_prompt\_upsampleron in the text-to-image templates; the distilled template ships with it on, the base template with it off. The editing templates have no upsampler branch: run the upsampler, or your own LLM, on the instruction and the references and paste its caption as the prompt, seePrompting.

Sample with the defaults of the checkpoint: 16 steps and no guidance for the distilled checkpoint, 50 steps and CFG 3.5 for the base checkpoint. For editing, pass up to 10 reference images with the prompt.

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#promptingPrompting

The caption controls composition; reference images anchor content, they do not lock structure.

• Always run a prompt upsampler, ours or your own LLM: the model takes full scene captions (framing, subject, background, lighting), and a short prompt sent as typed gives generic output. A one-line edit instruction (“make it blue”) reframes the shot.
• For edits, the prompt upsampler writes the caption from the instruction and the references: a complete caption of the reference with the edit folded in. For style, describe the attributes (palette, stroke, texture) rather than naming an artwork.
• For layout, append a JSON list of elements to the caption. Each box is\[top, left, bottom, right\]on a 0 to 1000 grid; tag the element in the caption with<id\>:

Minimalist graphic illustration featuring a black silhouette of a person <silhouette_1> centered against a solid, vibrant chartreuse background <background_1>. The figure is captured in a dynamic, mid-stride running pose, facing toward the left side of the frame. [{"id": "background_1", "bbox": [0, 0, 1000, 1000], "desc": "A flat field of neon yellow-green with a subtle paper texture and fine, organic grain."}, {"id": "silhouette_1", "bbox": [150, 150, 850, 850], "desc": "A black silhouette of a person in motion, made of dense stippled ink."}]

For edits by box, refer to the n-th reference as<ref\_image\_n\>and give each elementfrom,src\_bboxandtgt\_bbox; anulltarget removes it. The full format with worked examples:Bounding boxes.

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#limitationsLimitations

• This model is not intended or able to provide factual information.
• While the model can output text, text rendered may be inaccurate or subject to distortion.
• As a statistical model, this checkpoint may represent or amplify biases observed in the training data.
• The model may fail to generate output that matches the prompts.
• Prompt following is heavily influenced by the prompting style. Short prompts produce generic output.
• Boxes set placement and scale, not a hard mask: an element can extend past its box, and small requested elements may not appear. Edits can change content outside the requested region.

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#out-of-scope-useOut-of-scope use

See Section 4 of theFLUX Kommunity Licensefor the full restrictions. They include military purposes; surveillance, including related research and development; biometric processing; unlawful, unsafe, fraudulent, defamatory, or abusive activity; generating unlawful content, including child sexual abuse material or non-consensual intimate images; violating third-party rights, including rights of publicity or digital replica rights; and using the model, its Derivatives, or its Outputs to improve another AI model that performs a function similar to a FLUX Model or Derivative.

The license also covers export controls and sanctions. Its commercial-use exception is not blanket permission for commercial fine-tuning or distribution. Consult the full license for the terms that apply to each use.

Nothing contained in this model card should be interpreted as or deemed a restriction or modification to the license the model is released under.

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#responsible-ai-developmentResponsible AI Development

Black Forest Labs is committed to responsible model development and deployment. Prior to releasing FLUX 3 Image Klein, we evaluated and mitigated a number of risks, including child sexual abuse material (CSAM) and nonconsensual intimate imagery (NCII). For detailed information about our mitigations, evaluation processes, content provenance features, and policies, please see our post:Capable, Open, and Safe: Combating AI Misuse. To report safety concerns, contact[email protected].

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#licenseLicense

This model is released under theFLUX Kommunity License v.1.0: non-commercial use, plus commercial output generation by Qualifying Users with less than US$5M in gross annualized revenue, including affiliates, subject to the license terms. For other uses, seecommercial licensing.

The Qwen3-VL-4B-Instruct text encoder is underApache-2.0. The prompt upsampler is underApache-2.0.

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#trademarks-and-ipTrademarks and IP

Use of Black Forest Labs and FLUX trademarks requires prior written permission, except for required attribution or necessary descriptive references. Use must not cause confusion or imply sponsorship or endorsement. Third-party trademarks remain subject to their owners’ policies.

https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy#citationCitation

If you use FLUX 3 Image in your work, please cite:

@misc{bfl2026flux3image,
  author       = {{Black Forest Labs}},
  title        = {{FLUX} 3 Image Klein},
  year         = {2026},
  url          = {https://bfl.ai/blog/flux-3-image-klein},
}