gitwtfhub

wtf is krea2-multi-character-lora-node-w-bounding-box?

cliffnodes/krea2-multi-character-lora-node-w-bounding-box — explained in plain English

Analysis updated 2026-05-18

46PythonAudience · vibe coderComplexity · 3/5Setup · moderate

TL;DR

A ComfyUI node that places multiple character LoRAs in one image using boxes so each stays confined to its own region, plus a reference image lock to keep identities consistent.

Mindmap

mindmap
  root((Krea2 Multi LoRA))
    What it does
      Boxes per character
      No LoRA bleed
      Reference Lock
    Tech stack
      Python
      ComfyUI
      Krea 2
    Use cases
      Multi character images
      Consistent identity
      Scene layout control
    Recent fixes
      LoKr LoRA support
      Box row sync

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Generate one image containing multiple distinct characters without their LoRAs blending together.

REASON 2

Keep a character's face and identity consistent across a series of generated images using a reference photo.

REASON 3

Control the placement of objects, props, or backgrounds by drawing labeled boxes on the canvas.

REASON 4

Add a reference image to a scene element that has no trained LoRA, like a prop or location.

What's in the stack?

PythonComfyUI

How it stacks up

cliffnodes/krea2-multi-character-lora-node-w-bounding-boxagricidaniel/goghbetta-tech/harness-sdd
Stars464646
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an existing ComfyUI install with the Krea 2 model and any character LoRA files you want to use.

Wtf does this do

This project is a custom node for ComfyUI, a visual tool for building AI image generation workflows. It lets you place multiple characters in a single generated image, where each character comes from a different LoRA, a small add on file that teaches an image model a specific look or identity. Normally, mixing several LoRAs in one image causes them to bleed into each other, blending faces or styles together. This node fixes that by letting you draw a box for each character on the canvas and locking each LoRA strictly to its own box, so one character's LoRA never affects another region of the image. Beyond characters, the same boxes can control other parts of a scene too, such as objects, props, or backgrounds, when paired with a compatible prompt style, letting someone lay out an entire image by drawing and describing regions. The newest version adds a second feature called Reference Lock. Even with boxes preventing bleed within a single image, a LoRA alone does not guarantee a character looks exactly the same across many separate generations, since faces can drift slightly from one image to the next. Reference Lock lets you attach a reference image to any box, and during the image generation process, that box is nudged step by step toward matching the reference, in addition to the LoRA masking. This works even for boxes with no LoRA at all, useful for props or backgrounds you have a reference photo for but no trained LoRA for. Settings control how strongly the reference pulls the image and during which part of the generation process it applies. The README also documents a recent fix for a type of LoRA file called LoKr, which previously failed silently and appeared to do nothing when loaded. It is now correctly recognized and applied. Older versions of the node remain available and unaffected by these changes, so existing workflows continue to work.

Yoink these prompts

Prompt 1
Explain how to draw boxes and assign a LoRA to each character in this node.
Prompt 2
Walk me through setting up Reference Lock with ref_strength and ref_start_percent and ref_end_percent.
Prompt 3
What is the difference between the v1 LoRA masking and the v3 Reference Lock feature?
Prompt 4
Help me troubleshoot why my LoKr LoRA file was not applying any effect.

Frequently asked questions

wtf is krea2-multi-character-lora-node-w-bounding-box?

A ComfyUI node that places multiple character LoRAs in one image using boxes so each stays confined to its own region, plus a reference image lock to keep identities consistent.

What language is krea2-multi-character-lora-node-w-bounding-box written in?

Mainly Python. The stack also includes Python, ComfyUI.

How hard is krea2-multi-character-lora-node-w-bounding-box to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is krea2-multi-character-lora-node-w-bounding-box for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.