🧑📝 Character Description Generator

This node picks a character from a dropdown and hands you back a description of them, built from a JSON file living in ComfyUI/custom_nodes/Bjornulf_custom_nodes/characters. The pack ships a handful of characters out of the box - names like Jessica, Lukas, Albertine, Sean, Vanessa, Lily, Chinedu, Amina, Marcel, Julien show up in the picker - and the whole point is that you can add your own by dropping a matching JSON file into that folder.

It's one piece of a much bigger machine: the pack's "Text Generator" family (scenes, styles, poses, outfits, and this character node) is designed to chain together into a full prompt-building pipeline, mostly built and tested with FLUX in mind. This node is specifically the character slot in that chain - plug it into the main Text Generator node instead of typing a character description by hand every time.

Worth being upfront about, in the author's own words: this is "very basic," a work in progress, and "some details are unusable for some checkpoints" - meaning a description tuned to read well for one model might not translate cleanly to another. The JSON structure itself isn't locked down either, so treat this as a convenience for quickly trying character ideas, not a polished character-consistency solution. If genuine cross-image consistency for the same character is what you're after, that's a much bigger problem than one node can solve - the current state of the art there has moved toward editing a reference image with an instruction model rather than re-describing a character in text every time, which this node doesn't attempt.

The inputs and outputs that matter

There's exactly one input: character_file, a dropdown listing the JSON files in the characters folder. Pick one and the node does the rest - no other settings to tune.

Three outputs come back: sentences - a full-sentence description you can drop straight into a prompt; words - presumably a more compact, keyword-style version of the same character, useful for models that respond better to tags than to prose; and name - just the character's name as a string, handy for labeling saved outputs or routing logic elsewhere in your graph (the pack's "select an image, pick" and folder-saving nodes lean on exactly this kind of string for organizing output by character).

Installing it

Through ComfyUI Manager: search Bjornulf_custom_nodes, install, restart. Or by hand:

cd ComfyUI/custom_nodes
git clone https://github.com/justUmen/Bjornulf_custom_nodes

Then install the shared requirements.txt inside that folder. This node itself doesn't touch any of the heavier dependencies - it's just reading and formatting a JSON file - so it'll work fine even on a minimal install.

Where people get burned

If your dropdown shows only none or looks empty, check that the characters folder actually exists next to the node's Python files and that your JSON is well-formed - a broken JSON file in that folder is the most likely reason a "custom character" silently doesn't show up or doesn't generate a usable description. And because the JSON schema isn't stable across pack versions yet by the author's own admission, a custom character file you wrote against an older version of this node may need adjusting after an update - check the pack's changelog if a character you added stops working the way it used to.