Identity Forge

You know the loop. You sit in ComfyUI trying to describe a person, type "young woman, auburn hair, green eyes," and get a face that's suspiciously close to every other face you generated this week. Or you batch for variety and half the outputs are the same person in a slightly different outfit. Identity Forge is the node that breaks that loop: it's a character generator built out of dropdowns. Pick the traits you care about, leave the rest on Random, and every queue hands you a new, internally consistent person described in clean prose you can wire straight into CLIP Text Encode.

That's the whole pitch, and it earns it. The dropdowns run to roughly seventy fields across Demographics, Body, Face, Hair, Makeup, Jewelry & Nails, Clothing, and Setting & Shot - enough granularity that you can lock "redhead, freckled, 25, librarian-ish" and let everything else roll. But the real trick is what happens between the roll and the output.

Why it doesn't produce prompt soup

If you've come from the wildcard world ({brown|blonde|black} hair), you know the failure mode: nothing stops a randomizer from rolling a buzz cut and braids, or a handbag with gym gear, or an Irish subject in ebony skin. Identity Forge's answer is a constraint engine that resolves those clashes after the fact. A buzz cut never gets a braid, "no makeup" clears every cosmetic, an athletic outfit drops the handbag. The priority order is the part worth internalizing: a rule never overrides a field you locked. It logs an [IdentityForge] notice and keeps your value. So "lock what you care about, let the rest roll" isn't a tagline, it's the mechanism.

One more design choice to know about: gender is a hard gate, not a coherence rule. Point a masculine preset at a Female node and it never produces a beard - the engine drops the incompatible value and re-rolls it inside the female pool. gender: Any resolves to a coherent man or woman per seed, so you never get a beard sitting next to a feminine bust.

The inputs that actually matter

• seed - the control below defaults to randomize, so every run is a new person. Flip it to fixed and the same character comes back exactly. That's your reproducibility story, and it works.
• gender + wardrobe - gender: Any rolls a coherent man OR woman per run. Add wardrobe: Any and you unlock genuinely mixed-gender output. Want a man in feminine clothes without the mixed pools? wardrobe: Feminine.
• accessory_density - drop it to Minimal or None for clean portraits without hand-locking two dozen fields.
• location_setting - Studio / solid backdrop forces a plain, easily maskable background (grey, white, black, chroma-key green) plus clean studio light. Your inpaint-friendly backgrounds come from here.
• set_all_fields - All to None blanks every field still on Random, so only the ones you lock appear. Ideal for a character-only description you want to splice into a scene you write yourself.

The scene fields deserve their own warning because people trip on them. The location is what stands: if it rolls an indoor spot, the lighting adapts to it - you never get a spice-market stall lit by "dappled sunlight through forest canopy." Most locations are interiors, which is why random daylight is deliberately rare. Set location_setting: Outdoor when you want sunny golden-hour looks, or lock a light like harsh desert sun and the location re-rolls to fit it.

Outputs

The node emits two things: prompt_text (STRING) - the natural-language paragraph you connect to CLIP Text Encode - and prompt_json (STRING), the same character as structured JSON nested by group, with a small _meta block. The JSON is what you feed to the pack's own Vault Save node, or use however you like.

Install

Zero dependencies, fully offline - no LLM, no API keys, no model downloads. requirements.txt is a comment saying exactly that.

cd ComfyUI/custom_nodes
git clone https://github.com/EnragedAntelope/comfyui-identity-forge

Then restart ComfyUI. Or use ComfyUI Manager and search "Identity Forge". One catch: the pack is built on ComfyUI's V3 API (comfy_api.latest) and needs ComfyUI 0.25.0 or newer - if it doesn't load after install, update ComfyUI first.

Troubleshooting

The one issue the maintainer documents: after a pack update you can hit a NoneType error or a blank/missing widget on a saved graph. The node's fields are built when it's created, so an old node holds stale widgets. Delete and re-add the node (or recreate it) and it clears - reselect any locked values afterward. Worth knowing that locking a field on a cosplay character you then chain upstream will respect it; the node closest to Identity Forge wins where presets overlap.

Honest caveat before you go: this generates text, and the checkpoint renders the person. It won't give you the same face across fifty renders - that's LoRA/adapter territory, and Identity Forge is a complement to it, not a replacement. Use it to roll OCs until one clicks, then build consistency around that. For its actual job - fast, varied, coherent people for portraits, crowds, or just staring at fresh faces - it's hard to beat.