explaingit

cliffnodes/krea2-multi-character-lora-node-w-bounding-box

Analysis updated 2026-05-18

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

TLDR

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

PythonComfyUI

How does it compare?

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 get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.