Nodes/comfyui-character-prompt-builder/Character Prompt Builder - Female Person
ComfyUI Node

Character Prompt Builder - Female Person

Your character's entire face, browsed instead of typed

By euan-gwd·Created 8 months ago·Updated 29 days ago· 4
Character Prompt Builder - Female Person
  • settings_in
  • settings
genderWoman
age25
nationality_1British
nationality_2
nationality_mix0
body_type
height
body_weight
waist_size
breast_shape
breast_size
breast_cup_size
bum_size
face_shape
eyes_color
eye_shape
nose_shape
nose_size
lip_shape
lip_color
makeup
facial_expression
hair_style
hair_length
hair_color
skin_tone
skin_details
dimples
freckles
moles
skin_imperfections
skin_acne
tanned_skin
eyes_details
iris_details
circular_iris
circular_pupil
nipple_appearance
areola_appearance
tattoo

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, and waist_size dropdowns 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.

CategoryCharacterPromptBuilder

Inputs (41)

NameTypeDefaultDescription
genderCOMBOWoman1 options: Woman
ageINT2518–90
nationality_1COMBOBritish65 options: -, Afghan, Albanian, American, Argentine, Australian, +59
nationality_2COMBO65 options: -, Afghan, Albanian, American, Argentine, Australian, +59
nationality_mixINT00–100
body_typeCOMBO36 options: -, Underweight, Normal weight, Overweight, Obese, Beefy, +30
heightCOMBO28 options: -, 4ft10, 4ft11, 5ft0, 5ft1, 5ft2, +22
body_weightCOMBO24 options: -, 80lbs, 90lbs, 100lbs, 110lbs, 120lbs, +18
waist_sizeCOMBO11 options: -, Tiny, Narrow, Small, Medium, Thick, +5
breast_shapeCOMBO11 options: -, Round, Teardrop, Asymmetrical, East West, Side Set, +5
breast_sizeCOMBO8 options: -, Flat, Very small, Small, Medium, Large, +2
breast_cup_sizeCOMBO14 options: -, AA, A, B, C, D, +8
bum_sizeCOMBO26 options: -, Flat, Small, Medium, Large, Very Large, +20
face_shapeoptCOMBO14 options: -, Oval, Round, Square, Heart-shaped, Long, +8
eyes_coloroptCOMBO17 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_shapeoptCOMBO16 options: -, Almond, Asian monolid, Close-set, Deep-set, Double eyelid, +10
nose_shapeoptCOMBO21 options: -, Straight (Greek), Roman (Aquiline), Button, Snub, Hawk, +15
nose_sizeoptCOMBO16 options: -, Very small (petite, delicate), Small (subtle, less prominent), Medium (average, balanced), Large (broad, prominent), Very large (striking, dominant), +10
lip_shapeoptCOMBO19 options: -, Biting Lips, Bow-shaped Lips, Closed Lips, Cupid's Bow Lips, Full Lips, +13
lip_coloroptCOMBO17 options: -, Berry, Black, Blue, Brown, Burgundy, +11
makeupoptCOMBO16 options: -, Anime Makeup, Artistic Makeup, Avant-garde Makeup, Bohemian Makeup, Classic Makeup, +10
facial_expressionoptCOMBO213 options: -, Happy, Sad, Angry, Surprised, Fearful, +207
hair_styleoptCOMBO110 options: -, Asymmetrical cut, Blunt cut, Bob cut, Braided bob, Buzz cut, +104
hair_lengthoptCOMBO15 options: -, Bald, Buzzed, Very short, Short, Ear length, +9
hair_coloroptCOMBO78 options: -, Black, Brown, Blonde, Red, Auburn, +72
skin_toneoptCOMBO21 options: -, Very fair (porcelain, ivory), Fair (light beige, creamy), Light (peach, light sand), Light-medium (warm beige, honey), Medium (golden, olive, tan), +15
skin_detailsoptCOMBO4 options: -, subtle skin texture, noticeable skin texture, highly detailed skin texture
dimplesoptCOMBO4 options: -, subtle dimples, noticeable dimples, deep dimples
frecklesoptCOMBO4 options: -, a few freckles, noticeable freckles, prominent freckles
molesoptCOMBO4 options: -, a few moles, several moles, many moles
skin_imperfectionsoptCOMBO4 options: -, minor imperfections, natural imperfections, pronounced imperfections
skin_acneoptCOMBO4 options: -, a few blemishes, some acne, pronounced acne
tanned_skinoptCOMBO4 options: -, a hint of a tan, a sun-kissed tan, deeply tanned skin
eyes_detailsoptCOMBO12 options: -, highly detailed, subtle eye detail, naturally expressive, framed by defined eyelashes, bright with catchlights, +6
iris_detailsoptCOMBO13 options: -, intricate iris patterns, subtle iris pattern, natural iris striations, visible radial lines, complex iris texture, +7
circular_irisoptCOMBO6 options: -, perfectly round irises, slightly oval irises, unusually large round irises, small round irises, exaggerated circular irises
circular_pupiloptCOMBO7 options: -, realistic pupils, perfectly round pupils, slightly oval pupils, dilated pupils, constricted pupils, +1
nipple_appearanceoptCOMBO17 options: -, Small and flat, Small and raised, Medium-sized, slightly protruding, Large and prominent, Puffy (areola and nipple raised together), +11
areola_appearanceoptCOMBO22 options: -, Small diameter, Medium diameter, Large diameter, Very light pigmentation, Light pigmentation, +16
tattoooptCOMBO17 options: -, No tattoos, Small tattoo, Arm tattoo, Leg tattoo, Back tattoo, +11
settings_inoptPM_SETTINGS

Outputs (1)

NameTypeDescription
settingsPM_SETTINGS