Character Prompt Builder - Female Person
Your character's entire face, browsed instead of typed
- settings_in
- settings
Describing a face in a prompt box is where most people give up and type "beautiful woman" and hope. Character Prompt Builder - Female Person is the antidote: a wall of dropdowns that turn "I want a 28-year-old British woman with wavy blonde hair and freckles" into an actual written sentence, without you having to compose a single clause.
This is the node that starts the pack's chain. It takes nothing in except an optional settings_in, and hands a PM_SETTINGS dict out the settings port for the Fashion and Poses nodes to extend. Like every node in the pack, it doesn't generate text itself - it records choices until Scene & Generate turns them into prose.
The inputs that matter
There are thirty-odd inputs here and almost all of them are optional, which is both the feature and the trap. You don't need to set anything beyond age, and the default 25 is already there. What's worth actually touching:
- age - 18–90, and it's an integer spinner, so be precise: "27" stays "27" instead of being ignored.
- nationality_1 / nationality_2 / nationality_mix - the fun one. Pick two nationalities and a 0–100 mix slider to get "a British-Japanese woman" instead of a coin flip.
- body_type - 36 options ("Curvy", "Athletic", "Petite"…), plus
height,body_weight, andwaist_sizedropdowns if you want the model to be very specific about proportions. - facial_expression - 213 choices, from "Happy" to "Ecstatic" to things you've never seen a human do. The single highest-leverage input on the node.
- hair_style / hair_length / hair_color - 110 styles, 78 colors, and length. This is where a character stops being generic.
- skin_tone, plus the texture family:
skin_details,freckles,dimples,moles,skin_acne,tanned_skin. Subtle realism options that most prompt builders skip.
The rest - face shape, eye shape/color, nose shape/size, lip shape/color, makeup, eye/iris detail, tattoo - all sit in the optional block and default to "-". That's deliberate: the pack is modular, so you only fill in what the shot needs. For a headshot, face fields matter. For a full-body editorial, spend your time on body type and skin.
How it works
The node is a fork of the ComfyUI-Easy-Use lineage, which itself traces back to Portrait Master by AI Wiz Art. The idea hasn't changed in years: expose every describable attribute as a dropdown so the prompt is spelled exactly, then emit it in natural language. The natural-language part matters more now than it did in 2023 - modern LLM-encoded checkpoints (Flux's T5, and friends) want full sentences, not comma-tag soup, and this pack speaks that dialect natively.
Installing
Via ComfyUI Manager, search "Character Prompt Builder" and install, or:
cd ComfyUI/custom_nodes
git clone https://github.com/euan-gwd/comfyui-character-prompt-builder
Restart ComfyUI afterward. No pip dependencies (standard library only) and no model downloads. If the dropdown options look sparse on first run, the pack is downloading its character_prompt.json option data from GitHub - give it a moment, or confirm you're online.
The honest caveat
Dropdowns can't spell "the specific character in my reference image." This node is for building a character from scratch, not copying one. If you need identity preservation, pair it with an IPAdapter or a character LoRA downstream - think of the Person node as the skeleton and the LoRA as the soul. And one more thing: the pack removed explicit NSFW prompt content in v2.4.0, so don't come here expecting that; the physique fields that remain are for realism, not shock value.
Inputs (41)
| Name | Type | Default | Description |
|---|---|---|---|
| gender | COMBO | Woman | 1 options: Woman |
| age | INT | 2518–90 | — |
| nationality_1 | COMBO | British | 65 options: -, Afghan, Albanian, American, Argentine, Australian, +59 |
| nationality_2 | COMBO | 65 options: -, Afghan, Albanian, American, Argentine, Australian, +59 | |
| nationality_mix | INT | 00–100 | — |
| body_type | COMBO | 36 options: -, Underweight, Normal weight, Overweight, Obese, Beefy, +30 | |
| height | COMBO | 28 options: -, 4ft10, 4ft11, 5ft0, 5ft1, 5ft2, +22 | |
| body_weight | COMBO | 24 options: -, 80lbs, 90lbs, 100lbs, 110lbs, 120lbs, +18 | |
| waist_size | COMBO | 11 options: -, Tiny, Narrow, Small, Medium, Thick, +5 | |
| breast_shape | COMBO | 11 options: -, Round, Teardrop, Asymmetrical, East West, Side Set, +5 | |
| breast_size | COMBO | 8 options: -, Flat, Very small, Small, Medium, Large, +2 | |
| breast_cup_size | COMBO | 14 options: -, AA, A, B, C, D, +8 | |
| bum_size | COMBO | 26 options: -, Flat, Small, Medium, Large, Very Large, +20 | |
| face_shapeopt | COMBO | 14 options: -, Oval, Round, Square, Heart-shaped, Long, +8 | |
| eyes_coloropt | COMBO | 17 options: -, Natural Dark Brown (almost black), Natural Medium Brown (warm brown), Natural Light Brown (amber or honey, golden brown), Natural Hazel (brown with green or gold flecks), Natural Grey (light to deep grey), +11 | |
| eye_shapeopt | COMBO | 16 options: -, Almond, Asian monolid, Close-set, Deep-set, Double eyelid, +10 | |
| nose_shapeopt | COMBO | 21 options: -, Straight (Greek), Roman (Aquiline), Button, Snub, Hawk, +15 | |
| nose_sizeopt | COMBO | 16 options: -, Very small (petite, delicate), Small (subtle, less prominent), Medium (average, balanced), Large (broad, prominent), Very large (striking, dominant), +10 | |
| lip_shapeopt | COMBO | 19 options: -, Biting Lips, Bow-shaped Lips, Closed Lips, Cupid's Bow Lips, Full Lips, +13 | |
| lip_coloropt | COMBO | 17 options: -, Berry, Black, Blue, Brown, Burgundy, +11 | |
| makeupopt | COMBO | 16 options: -, Anime Makeup, Artistic Makeup, Avant-garde Makeup, Bohemian Makeup, Classic Makeup, +10 | |
| facial_expressionopt | COMBO | 213 options: -, Happy, Sad, Angry, Surprised, Fearful, +207 | |
| hair_styleopt | COMBO | 110 options: -, Asymmetrical cut, Blunt cut, Bob cut, Braided bob, Buzz cut, +104 | |
| hair_lengthopt | COMBO | 15 options: -, Bald, Buzzed, Very short, Short, Ear length, +9 | |
| hair_coloropt | COMBO | 78 options: -, Black, Brown, Blonde, Red, Auburn, +72 | |
| skin_toneopt | COMBO | 21 options: -, Very fair (porcelain, ivory), Fair (light beige, creamy), Light (peach, light sand), Light-medium (warm beige, honey), Medium (golden, olive, tan), +15 | |
| skin_detailsopt | COMBO | 4 options: -, subtle skin texture, noticeable skin texture, highly detailed skin texture | |
| dimplesopt | COMBO | 4 options: -, subtle dimples, noticeable dimples, deep dimples | |
| frecklesopt | COMBO | 4 options: -, a few freckles, noticeable freckles, prominent freckles | |
| molesopt | COMBO | 4 options: -, a few moles, several moles, many moles | |
| skin_imperfectionsopt | COMBO | 4 options: -, minor imperfections, natural imperfections, pronounced imperfections | |
| skin_acneopt | COMBO | 4 options: -, a few blemishes, some acne, pronounced acne | |
| tanned_skinopt | COMBO | 4 options: -, a hint of a tan, a sun-kissed tan, deeply tanned skin | |
| eyes_detailsopt | COMBO | 12 options: -, highly detailed, subtle eye detail, naturally expressive, framed by defined eyelashes, bright with catchlights, +6 | |
| iris_detailsopt | COMBO | 13 options: -, intricate iris patterns, subtle iris pattern, natural iris striations, visible radial lines, complex iris texture, +7 | |
| circular_irisopt | COMBO | 6 options: -, perfectly round irises, slightly oval irises, unusually large round irises, small round irises, exaggerated circular irises | |
| circular_pupilopt | COMBO | 7 options: -, realistic pupils, perfectly round pupils, slightly oval pupils, dilated pupils, constricted pupils, +1 | |
| nipple_appearanceopt | COMBO | 17 options: -, Small and flat, Small and raised, Medium-sized, slightly protruding, Large and prominent, Puffy (areola and nipple raised together), +11 | |
| areola_appearanceopt | COMBO | 22 options: -, Small diameter, Medium diameter, Large diameter, Very light pigmentation, Light pigmentation, +16 | |
| tattooopt | COMBO | 17 options: -, No tattoos, Small tattoo, Arm tattoo, Leg tattoo, Back tattoo, +11 | |
| settings_inopt | PM_SETTINGS | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| settings | PM_SETTINGS | — |