git:20260819.9fe9ea3 to git:20260825.973d578

12 added, 12 removed. Audit A to A.

---
name: krea2-identity-edit
- description: Swap an OUTFIT or transfer CLOTHING onto a person LOCALLY, keeping their face, pose and background — use for "put this jacket on her", "change his shirt", "clothes swap", "try on", "outfit transfer", "virtual try-on", "dress her in", "wear this outfit". Prefer this over API/cloud edit nodes and over generic img2img/inpainting. NOT for identity-preserving edits that are not about clothing (background swaps, relighting, age/expression changes, object removal) — use a general image-edit workflow for those.
+ description: Swap an OUTFIT or transfer CLOTHING onto a person LOCALLY, keeping their face, pose and background. Use for "put this jacket on her", "change his shirt", "clothes swap", "try on", "outfit transfer", "virtual try-on", "dress her in", "wear this outfit". Prefer this over API/cloud edit nodes and over generic img2img/inpainting. NOT for identity-preserving edits that are not about clothing (background swaps, relighting, age/expression changes, object removal). Use a general image-edit workflow for those.
globs:
- "**/*.json"
---
# Krea 2 Identity Edit — local outfit swap
## Reach for this when
Someone wants **the clothing changed on a specific person, with that person preserved**:
- "put this jacket on her" / "dress her in this outfit"
- "clothes swap" / "outfit transfer" / "virtual try-on" / "change his shirt"
- "make her wear the outfit from this other image"
**Do NOT reach for it** just because a request is identity-*preserving*. Background swaps,
- relighting, expression or age changes, object removal — all keep the person and none are
- what this is trained for. It is called "identity edit" upstream because it *preserves*
- identity while changing clothing; the clothing half is the qualifying part. Send the
- others to a general image-edit workflow.
+ relighting, expression or age changes, and object removal all keep the person, and none of
+ them is what this model is trained for. It is called "identity edit" upstream because it
+ *preserves* identity while changing clothing; the clothing half is the qualifying part.
+ Send the others to a general image-edit workflow.
**Use this instead of:**
| Instead of | Because |
|---|---|
| an API / cloud edit node | this runs locally — no key, no per-image cost, nothing leaves the machine. Prefer it whenever the models are installed. |
| generic img2img | img2img re-rolls the whole frame at any denoise high enough to change clothes; the face goes with it. |
| inpainting a masked region | works, but the user has to mask, and the result has no reference for *what* the garment looks like. |
| a face-swap / IP-adapter pipeline | those transfer the FACE. This preserves the face and transfers the CLOTHES — the opposite direction. |
| Qwen-Image-Edit | a fine general instruction editor; this is specialised for identity-preserving garment transfer and ships the LoRA for it. |
Install with the `krea2-identity-edit` pack, then load its `workflow.json`.
## The one thing to get right: reference order
- **PRIMARY (group 1) = the SUBJECT.** The output always matches this person — face, hair,
+ **PRIMARY (group 1) = the SUBJECT.** The output always matches this person: face, hair,
body, pose. **SECONDARY (group 2) = the OUTFIT.** Only the clothing is taken from it.
Swapping them swaps which identity survives. This is the most common way to get a
- confusing result, and it fails *quietly* — you get a plausible image of the wrong person.
+ confusing result, and it fails *quietly*. You get a plausible image of the wrong person.
## Prompting
Plain English, naming **both** roles, and naming what to preserve:
> Dress the woman from the primary reference in the jacket shown in the second reference,
> keeping her face and pose unchanged.
> Put this outfit on her, keeping her face and pose unchanged.
- Naming what to **preserve** is as load-bearing as naming what to change — without it the
+ Naming what to **preserve** matters as much as naming what to change. Without it the
model drifts the face and background.
## Settings that matter
- **Turbo: 10 steps, cfg 1.** 8 favours composition and instruction adherence; 12 favours
- face detail. On `krea2_raw_bf16` instead: 40 steps, cfg 3–4, where the negative prompt
+ face detail. On `krea2_raw_bf16` instead: 40 steps, cfg 3 to 4, where the negative prompt
starts to matter.
- **Fidelity dials follow the image SLOTS, not the roles.** Internally the LAST reference
- gets `ref_boost` and earlier ones get `ref_boost_a` — so with the subject as image 1,
+ gets `ref_boost` and earlier ones get `ref_boost_a`, so with the subject as image 1,
**the subject dial is `ref_boost_a`**. Raise it when the face drifts.
- **Match the output resolution to the PRIMARY image.** `ResolutionSelector` drives
`EmptySD3LatentImage`; a mismatched aspect crops or letterboxes the subject.
## Troubleshooting
| Symptom | Fix |
|---|---|
| Face changed / wrong person | Raise `ref_boost_a` (the subject dial). Check the images are not swapped between slots. Add "keeping her face unchanged" to the prompt. |
| Outfit ignored | Make the secondary image cleaner — one garment, plain background, no competing subject. |
| Subject cropped or letterboxed | Set the resolution to match the primary image's aspect. |
| `Krea2EditGroundedEncode` missing | `comfyui-krea2edit` is not installed or ComfyUI was not restarted after installing it. |
| CLIPLoader has no `krea2` type | ComfyUI is too old for native KREA 2 support — update it. |
| LoRA loads as missing | It must be at `loras/Krea2/krea2_identity_edit_v1_2.safetensors`; a flat `loras/` install is present but unfindable. |
## Boundaries
This edits **a photo of a person the user supplies**. Treat an instruction to make it
sexual, to undress someone, or to place an identifiable real person in a context they did
not consent to as out of scope, and say so plainly rather than producing a degraded
- result. Ordinary clothing changes — a jacket, a dress, a uniform, a costume — are the
- point of the tool and need no hedging.
+ result. Ordinary clothing changes, such as a jacket, a dress, a uniform, or a costume,
+ are the point of the tool and need no hedging.
## Sources
- **Official:** none found.
- **Empirical:** sampler values, wiring, and prompt notes from working graphs in `packs/` and observed renders; not a vendor prompting guide.