Extensions/Identity Forge

ComfyUI Extension

Identity Forge

A 70+ field character randomizer node pack for ComfyUI with a constraint engine, themed archetype presets with varying costumes, and dual prose/JSON output.

By EnragedAntelope·Created 2 months ago·Updated a day ago· 17

EnragedAntelope/comfyui-identity-forge

Nodes7

On cloudLocal install

Categoryconditioning/character

Stars17

Updateda day ago

Nodes (7)

Identity Forge

One queue, a brand-new person every time — ComfyUI's Identity Forge, explained

conditioning/character

Identity Forge Archetype

A themed look on a person who still randomizes underneath

conditioning/character

Identity Forge Cosplayer

Drop a random person into Spider-Man's suit (or 2B's) — cosplay without the prompt fight

conditioning/character

Identity Forge Creature

A praying-mantis body with a sloth's head — slot-by-slot creature hybrids in ComfyUI

conditioning/character

Identity Forge Modifier

A scalpel for one element of a character

conditioning/character

Identity Forge Vault Load

Pull a saved character back into your graph with one dropdown

conditioning/character

Identity Forge Vault Save

The Identity Forge vault, explained

conditioning/character

Readme

ComfyUI Identity Forge

Believable people from dropdowns — no prompt-wrangling. Queue once and you get a coherent, fully described person. Queue again and you get someone completely new. Identity Forge turns menu choices into clean natural-language prose (straight into CLIP Text Encode) plus a structured JSON record.

A constraint engine keeps every result sensible — no beard on the buzz cut, no handbag with the gym kit, no open-sky sunlight indoors, and a skin tone that stays plausible for the chosen ancestry in either direction. Lock the few traits you care about; let the rest roll.

Why you'll like it

Coherent by design — clashing traits get resolved for you, automatically.
Reproducible — seed-driven, so a person you liked comes back exactly.
Yours to steer — every field is roll it, lock it, or leave it out.
Zero dependencies, fully offline — no LLM, no API keys, no model downloads.

Optional layers

Four preset nodes stack in front of Identity Forge to steer the look. Each one is optional and passes through when you set it to None, so you can leave them all wired and just toggle. Archetype drops a themed look (knight, sorceress, astronaut, surgeon…) onto a still-random person. Creature turns that person into an animal, monster or alien. Modifier tweaks one field or a whole group. And Cosplayer puts a fictional character's costume on a random, optionally cross-gender person.

The Cosplayer node is worth a special mention: most character wildcards emit a name and hope the model recognises it. Every character here instead carries a hand-written, canon-checked description of the costume — garments, colours, masks, markings, signature props — so the look renders even on checkpoints that have never heard of the character. Ask a plain wildcard for Chun-Li and your prompt says Chun-Li; ask this one and you get the blue qipao with gold trim, the brown tights, the white cross-laced boots and the spiked bracelets.

Browse what's on offer — a searchable sample render for every entry: cosplay gallery · archetype gallery · creature gallery. Or read the full lists: cosplay characters · archetypes · creatures. Something obvious missing? Open an issue — suggestions are welcome.

Built on the ComfyUI V3 API (comfy_api.latest). Category: conditioning/character.

Showcase

Chain the preset nodes into the main Identity Forge node — the node closest to Identity Forge wins any conflict:

A taste of archetypes, cosplay characters and creatures:

[!TIP] Browse the galleries — cosplay · archetypes · creatures Every entry on every roster with a sample render, searchable by name and franchise — so you can see the look before you pick the name. Each gallery also links the exact ComfyUI workflow its samples were made with. Generated with the Krea2 T2I model on randomized identities, so your own results will vary.

Sample outputs

Identity Forge — random people:

Archetypes — themed looks on a random person:

Cosplayers — a fictional character's costume on a random (optionally cross-gender) person:

Creatures — the character rendered as a non-human form:

The nodes

| Node | What it does | | --- | --- | | Identity Forge | Lockable dropdowns in collapsible groups + the constraint engine → prompt_text (prose) and prompt_json. | | Archetype | Themed presets (knight, sorceress, pirate, samurai, pop star, astronaut, surgeon, 1950s homemaker…) that set the look while the person randomizes. | | Cosplayer | Fictional characters (Spider-Man, 2B, She-Hulk, Zelda…) as a cosplay look — the costume on a random, optionally cross-gender person. | | Creature | Render the character as a non-human form (animal, insect, marine, reptile, bird, monster, alien, mythic, plant), across all classes or one, hybridized slot-by-slot. | | Modifier | Prepend a custom descriptor to one field (footwear: sci-fi) or a whole group (Clothing: weathered). | | Vault Save / Load | Save a generated character (with a thumbnail) to a local vault; recall it later as a chainable preset, with a Manage Vault gallery. |

Install

Clone into custom_nodes and restart ComfyUI (no Python dependencies):

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

Or install via ComfyUI Manager (search Identity Forge).

Quick start

Add Identity Forge, connect prompt_text → CLIP Text Encode.
Leave fields on Random, or pick a value to lock the ones you care about.
Queue. The seed auto-randomizes, so each run is a new character (set the seed control to fixed to reproduce one).

Chaining presets

The Archetype, Cosplayer, Creature and Modifier nodes all feed Identity Forge's single archetype_json socket. Instead of swapping plugs, chain them through each node's optional upstream input:

Archetype ─▶ Cosplayer ─▶ Creature ─▶ Modifier ─(character_json)─▶ Identity Forge.archetype_json

The node closest to Identity Forge wins where fields overlap; non-overlapping upstream values survive.
Set any node to None and it passes its upstream through — keep every preset wired and just toggle which is active.

The headline combo: a Cosplayer in front of a Creature gives Superman as an anthropomorphic praying-mantis hybrid with a sloth's head — the costume survives, the body becomes the creature.

Using with Stylebook

Stylebook describes the rendering: medium, lighting, colour grade, era, finish and mood. Identity Forge describes the subject — who or what is in the picture, and where the camera is: framing, shot type, composition, pose, expression and eye contact. Connect Identity Forge's prose output into Stylebook's user_prompt and chain Stylebook downstream.

Stylebook owns lighting and mood, so set both to None here when pairing the two packs — otherwise you get two descriptions competing for the same axis. See Stylebook's examples/stylebook_with_identity_forge.json for a ready-to-run workflow.

Must-know

Seed auto-randomizes each run; set it to fixed to reproduce a character. Not written to the JSON.
Every field is Random (roll) / a value (lock) / None (omit). Set scene fields (location, lighting, framing) to None for a character-only description to splice elsewhere.
accessory_density — drop it to Minimal/None for clean portraits without locking fields by hand.
size_scale — force an unrealistic body scale on an ordinary person: a doll-sized office worker, a fifty-foot commuter. It is manual only; Auto is the default and is never chosen at random, so it can't affect normal output. Picking a tier replaces the height description in the opening sentence and overrides a wired character's own scale, so you can make anyone giant or tiny.
The scene shows the scale. A giant only looks giant if the frame has something to compare against, so a giant tier — or a canonically giant character like Godzilla or the Iron Giant — moves the shot outdoors and picks a wide, low or establishing framing, and stops the build being described as petite. Lock location or shot_type yourself and your choice wins as always. Tiny characters get the lighter version: only the framings too wide to resolve them are dropped.
The light matches the place. Indoor locations never draw open-sky light and outdoor ones never draw window or hearth light, and a light naming a physical fixture — a hearth, a television, a stained-glass window, a stage rig — only appears where that fixture exists. The location stands and the light adapts; lock a light instead and the location re-rolls to somewhere it can exist. Most locations are interiors, so set location_setting: Outdoor when you want sunny, golden-hour looks. The pool includes named world landmarks (the Eiffel Tower plaza, Shibuya Crossing, Uluru, the Cliffs of Moher) alongside everyday places.
The outfit is built, not just picked. outfit_style chooses a garment set, then clothing_color, clothing_pattern and footwear are composed onto it — "a jewel-toned satin slip gown with delicate straps, in strappy heels". Locking any of them changes the outfit, and the shoes are kept plausible for the style (no slippers with a business suit). A garment that names its own colour or shoes keeps them and the matching field steps aside. A costume from the Cosplayer or Archetype node is a complete look and overrides all of this.
Nothing is worn twice. If a costume or outfit already names a necklace, earrings, a ring, a bangle, a bag or a hat, the randomizer does not add a second one.
The pose fits the body. Poses that reach for something the subject does not have are never drawn: hair to run a hand through under a helmet, pockets on a mascot suit, a free hand when a signature prop is switched on (no more "hands in pockets, holding Mjolnir"), or a seat to perch on when the subject is fifty feet tall outdoors. Lock a pose and your choice wins.
A mask hides the face — unless you say otherwise. A full-mask character drops the randomized face, hair, makeup and expression, so nothing contradicts the helmet. Set any of those widgets yourself and it renders anyway: the character's own look stays hidden, your explicit choice does not.
Gender & crossplay. The person's gender is the Identity Forge gender widget, independent of any character's. Any rolls a coherent man or woman each run; pair it with wardrobe: Any for fully mixed-gender output. Locked / archetype / cosplayer values always win.
Scope the random character. On the Cosplayer node, random_scope narrows the Random — … picks to an attribute (Giant, Tiny, Non-human / colored, Masked, Mascot / full-suit), a broad category (Anime & Manga, Marvel, DC, …), or a single franchise. It combines with gender, and the console prints the in-scope pool size the first time you use a combination. If a franchise has nobody of the chosen gender, the scope wins and the gender relaxes — crossplay makes that valid anyway.
Alternate costumes. Characters with more than one iconic look (Harley Quinn, Catwoman, Poison Ivy, …) rotate between them by seed, so the same character yields a different signature costume each roll.
Non-human skin colour skips ethnicity too. When a character's colour covers the whole body (She-Hulk's green, Lobo's chalk-white), the wearer's ethnicity is dropped along with the human skin tone — naming one only fought the colour and left the face rendering as an ordinary human above a coloured body.
Fully-encased cosplays skip ethnicity. With no visible skin or face left (Iron Giant, a droid), mentioning the cosplayer's ethnicity only risked nudging the render toward a stray human trait. Face-visible cosplays still describe the person underneath as usual.
Masked characters (Spider-Man, a Mandalorian helmet) suppress the randomized face/hair so only the mask shows; the Cosplayer Unmask toggle reveals the head under the suit.
Vault — Vault Save is a terminal node used like Save Image (branch prompt_json in, optionally the image for a thumbnail; mute it to skip). Vault Load recalls a save as a character_json that wires into archetype_json.

Troubleshooting

A NoneType error (or a missing/blank widget) after updating. A node's fields are built when it is created, so a node on a saved graph can hold a stale widget after an update changes the options. Right-click the node and choose Fix node (recreate) and the error clears — every widget value and every link is preserved (this pack ships its own working recreate; ComfyUI- Manager's own version of that menu entry can fail on the current frontend — see docs/architecture.md).

Learn more

docs/usage.md — controls, locking, constraints, custom options (user_options.json), the field set, and a worked example.
docs/cosplayer-notes.md · docs/creature-notes.md — per-node design notes and how to add your own characters / creatures.
docs/architecture.md — schemas and engine internals for contributors.

Contributing characters & archetypes

Add private entries via user_options.json (see Custom options in docs/usage.md) — or open an issue / PR proposing new cosplayers, archetypes, outfit styles, creatures or fields to fold into the built-in set. For cosplayers, a costume description (worn items only) and the franchise are enough to start; mark covers_face + mask if the head is fully covered. The advanced flags (covers_body, covers_hair, bald, body_paint + skin) also work in custom entries — see the commented examples in user_options.example.json.

Development

The engine runs without ComfyUI:

python tests/validate_data.py                 # data integrity
python -m unittest discover -s tests -t . -v  # engine + integration tests

js/identity_forge.js embeds data generated from data/fields.py by scripts/generate_js_data.py — rerun it (and commit the result) after changing the field set or the gender-divergent pools; CI's --check catches a stale commit.

A jsdom suite exercises the real, unmodified frontend files outside a browser (wiring, collapse/expand, gender pool swaps, the vault dialog, "Fix node (recreate)") — see docs/architecture.md for what it does and doesn't catch.

npm ci
npm run test:frontend

License

MIT — see LICENSE.