molbal/comfyui-krea2-multiref — explained in plain English
Analysis updated 2026-05-18
Add multi-reference image conditioning to a Flux-based ComfyUI image generation workflow.
Encode a prompt together with up to four reference images through the Krea2 text encoder.
Attach pre-encoded reference image data to a workflow without re-encoding the prompt text.
Debug a diffusion model's internals inside a ComfyUI workflow using the diagnostic node.
| molbal/comfyui-krea2-multiref | 0xallam/my-recipe | 0xhassaan/nn-from-scratch | |
|---|---|---|---|
| Stars | 0 | — | 0 |
| Language | Python | Python | Python |
| Last pushed | — | 2022-11-22 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | — | moderate | moderate |
| Complexity | — | 2/5 | 4/5 |
| Audience | developer | general | developer |
Figures from each repo's GitHub metadata at analysis time.
ComfyUI-Krea2-MultiRef is a small set of custom nodes for ComfyUI, the visual workflow tool used for building AI image generation pipelines. This project adds support for Krea2-style multi-reference image editing, where a prompt can be paired with several reference images at once instead of just one. The package includes four nodes. The Krea2 Model Patcher adjusts a Flux diffusion model so it can accept reference image data while it generates an image. The Krea2 Reference Text Encode node takes a written prompt together with up to four reference images and passes them through the Krea2 Qwen3-VL text encoder, and can also attach reference image data directly if a VAE is connected. A second node, the Krea2 Reference Encoder, does the same reference-attaching step but skips re-encoding the text, for cases where only the images need to be added. The last node, Krea2 Diagnostic, simply prints internal details of the diffusion model, meant for debugging a workflow rather than everyday use. To use it, a person drops the folder into ComfyUI's custom_nodes directory and restarts ComfyUI. Inside a workflow, they load a Flux model, connect it to the Model Patcher, then add the Reference Text Encode node with the model's CLIP, a VAE, and their reference images, along with their own prompt, before feeding everything into a standard KSampler node. It requires a ComfyUI setup that already supports the Krea2 or Qwen3-VL text encoder, plus the einops library, which usually ships with ComfyUI already. Reference images are automatically shrunk to a maximum of 512 by 512 pixels before being read by the vision model, and reference image data is capped at 1024 by 1024 pixels. The project's own README says plainly that it is a temporary placeholder and will be expanded later, and the repository description marks the whole project as a work in progress. No license information is given in the source material.
A small ComfyUI plugin that lets an image generation prompt use several reference images at once with the Krea2 encoder.
Mainly Python. The stack also includes Python, ComfyUI, Flux.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.