ComfyUI Extension: Identity Forge

Authored by EnragedAntelope

Created about a month ago

Updated 14 days ago

11 stars

Run ComfyUI workflows without the setup

No installs, no CUDA version roulette, no GPU sitting idle on your bill. Bring a workflow and run it in the browser.

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

Looking for a different extension?

Custom Nodes (7)

README

ComfyUI Identity Forge

Endless, coherent characters from dropdowns — no prompt-wrangling. Queue once for a believable person; queue again for a brand-new one. Identity Forge turns menu choices into clean natural-language prose (for CLIP Text Encode) plus a structured JSON record — with a constraint engine that keeps every result sensible: no beard on the buzz-cut, no handbag with the gym kit, and skin tone that stays plausible for the chosen ancestry in either direction — no Irish subject in ebony skin, no West African subject in porcelain. Lock the few traits you care about, let the rest roll.

Why you'll like it

Coherent by design — a constraint engine resolves clashing traits for you, automatically.
Reproducible — seed-driven, so any character you like comes back exactly.
Archetypes & cosplayers — a deep library of themed looks and fictional-character costumes dropped onto an ever-changing person, with crossplay and a helmet-off Unmask toggle.
Creature layer — render the character as an animal / monster / alien, hybridized slot-by-slot (a praying-mantis body with a sloth's head), anthropomorphic, feral or a subtle accent.
Chainable — Archetype → Cosplayer → Creature → Modifier → Identity Forge stack instead of fighting over one socket; a character vault saves and recalls the ones you love.
Zero dependencies, fully offline — no LLM, no API keys, no model downloads.

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:

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.

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.
The light matches the place. An indoor location never draws open-sky light and an outdoor one never draws window/ceiling/hearth light, so you won't get a spice-market stall lit by "dappled sunlight through forest canopy". The location is what stands: the light adapts to it. Lock a light instead (e.g. harsh desert sun) and the location re-rolls to somewhere that light can exist. Most locations are interiors, so random daylight is uncommon by design — set location_setting: Outdoor when you want sunny, golden-hour looks.
Fully-encased cosplays skip ethnicity. A character with no visible skin or face left (Iron Giant, Ultraman, a droid) no longer mentions the cosplayer's ethnicity — with nothing human left showing, the mention only risked nudging the render toward a stray human trait. A face-visible or partially-covered cosplay still describes the person underneath as usual.
Gender & crossplay. The person's gender is the Identity Forge gender widget (independent of a character's). Any rolls a coherent man or woman each run; pair it with wardrobe: Any to unlock fully mixed-gender output. Locked / archetype / cosplayer values are always respected.
Scope the random character. On the Cosplayer node, random_scope limits the Random — … picks to one franchise/category (Anime & Manga, Marvel, DC, Star Wars, …) or to an attribute scope (Giant characters, Tiny characters, Non-human / colored, Masked), and combines with gender.
Alternate costumes. Characters with more than one iconic look (Harley Quinn, Catwoman, Poison Ivy, Titania, Giganta, Diane, …) rotate between them by seed, so the same character yields a different signature costume each roll.
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. Recreate the node - or delete and re-add it - and the error clears. You may have to reselect any locked values after recreation (but it's worth it, because that means improvement!).

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 -v  # engine + integration tests

js/identity_forge.js embeds data generated from data/fields.py — regenerate it only if you change the gender-divergent fields or the field set.

License

MIT — see LICENSE.

Run ComfyUI workflows without the setup

No installs, no CUDA version roulette, no GPU sitting idle on your bill. Bring a workflow and run it in the browser.

Learn more