Extensions/comfyui-character-prompt-builder
ComfyUI Extension

comfyui-character-prompt-builder

A modular character prompt generator for ComfyUI

By euan-gwd·Created 8 months ago·Updated 22 days ago· 4
euan-gwd/comfyui-character-prompt-builder
Nodes8
On cloudLocal install
CategoryCharacterPromptBuilder
Stars4
Updated22 days ago

Nodes (8)

Character Prompt Builder - Female Fashion

67 tops, 62 bottoms, one Target polo

CharacterPromptBuilder
Character Prompt Builder - Female Person

Your character's entire face, browsed instead of typed

CharacterPromptBuilder
Character Prompt Builder - Female Poses

The pose node that finally spells 'hands on hips' out for you

CharacterPromptBuilder
Character Prompt Builder - Male Fashion

From 'old money' to knight armor, without typing a word

CharacterPromptBuilder
Character Prompt Builder - Male Person

Finally, a character builder that knows beards exist

CharacterPromptBuilder
Character Prompt Builder - Male Poses

Boxer's stance, throne pose, or hands in pockets — pick one

CharacterPromptBuilder
Character Prompt Builder - Scene & Generate

The node that turns a pile of dropdowns into a real sentence

CharacterPromptBuilder
Character Prompt Builder - Render Prompt

The one node where you can actually fix the prompt before it hits CLIP

CharacterPromptBuilder
Readme

CharacterPromptBuilder

A standalone, modular prompt generator for ComfyUI. Generate detailed, natural language prompts for characters with extensive customization options.

ComfyUI Python License

Features

  • 🎨 Modular Design - Chainable nodes for maximum flexibility
  • 📝 Natural Language Output - Generates flowing, descriptive prompts
  • 👤 Comprehensive Person Options - Age, gender, nationality, body type, face, hair, skin
  • 👗 Fashion & Accessories - Female and male outfits, shoes, jewelry, nails
  • 🏃 Action & Pose Control - Dedicated node for actions, poses, gestures
  • 📸 Scene Control - Camera shots, lighting, location, weather, character sheets
  • 🔗 Chainable Architecture - Use only the nodes you need
  • 📦 Zero Dependencies - Uses only Python standard library

Installation

Method 1: Git Clone

cd ComfyUI/custom_nodes
git clone https://github.com/euan-gwd/comfyui-character-prompt-builder.git

Method 2: Manual Download

  1. Download the latest release
  2. Extract to ComfyUI/custom_nodes/comfyui-character-prompt-builder
  3. Restart ComfyUI

Nodes

👩 Character Prompt Builder - Female Person

Controls physical appearance for female characters:

| Category | Options | |----------|---------| | Subject | Gender (Woman/Girl), age (18-90), nationality, body type | | Body | Breast size/shape, bum size (with weights) | | Face | Face shape, eye color, expression, lips, makeup | | Hair | Style, length, color | | Skin | Details, freckles, dimples, moles, tan, acne | | Eyes | Detail level, iris patterns, pupil shape |

👨 Character Prompt Builder - Male Person

Controls physical appearance for male characters:

| Category | Options | | ----------- | ----------------------------------------------------- | | Subject | Gender (Man/Boy), age (18-90), nationality, body type | | Face | Face shape, eye color, expression, facial hair | | Hair | Male hairstyles, length, color | | Skin | Details, freckles, dimples, moles, tan, acne | | Eyes | Detail level, iris patterns, pupil shape |

👗 Character Prompt Builder - Female Fashion

Controls clothing and accessories for female subjects:

| Category | Options | | ----------- | ----------------------------------------------- | | Style | Fashion aesthetic (Gothic, Bohemian, Y2K, etc.) | | Outfit | Dresses, skirts, tops, revealing outfits | | Shoes | Women's shoes, colors | | Jewelry | Necklaces, earrings, bracelets, rings | | Nails | Style, color |

🧥 Character Prompt Builder - Male Fashion

Controls clothing and accessories for male subjects:

| Category | Options | | --------------- | ------------------------------------------------------------ | | Style | Fashion aesthetic (Gentleman, Military, Biker, Knight, etc.) | | Outfit | Suits, shirts, jackets, pants | | Shoes | Men's shoes, colors | | Accessories | Watches, necklaces, bracelets, rings, hats |

💃 Character Prompt Builder - Female Actions

Controls pose, action, and props for female subjects:

| Category | Options | | ---------- | ---------------------------------------------- | | Pose | Standing, kneeling, sitting, laying down poses | | Hand Placement | Optional: hands behind head, on hips, in lap, etc. | | Leg Placement | Optional: legs spread, crossed, raised, etc. | | Head Placement | Optional: tilted, looking up, looking down, etc. | | Props | Phones, bags, flowers, cameras, etc. | | Custom | Free-text action description |

🏃 Character Prompt Builder - Male Actions

Controls pose, action, and props for male subjects:

| Category | Options | | -------------- | --------------------------------------------------- | | Pose | Masculine standing, kneeling, sitting, laying poses | | Hand Placement | Optional: hands behind head, on hips, in lap, etc. | | Leg Placement | Optional: legs spread, crossed, raised, etc. | | Head Placement | Optional: tilted, looking up, looking down, etc. | | Props | Swords, guns, sports equipment, tools, etc. | | Custom | Free-text action description | | Expression | Additional facial/body expressions |

📸 Character Prompt Builder - Scene & Generate

Controls the shot setup and generates the final prompt:

| Category | Options | | --------------- | ---------------------------------------- | | Camera | Shot type, angle | | Lighting | Light type, direction, intensity | | Location | Free-text location description | | Environment | Time of day, weather, season | | Prompts | Prefix, suffix, enforce subjects only | | Output | Natural language prompt mode |

📝 Character Prompt Builder - Render Prompt

A utility node that displays the generated prompt and allows for manual edits before passing it to CLIP:

  • Display - Shows the final generated natural language prompt
  • Edit - Allows manual adjustments to the prompt directly on the node
  • Persistence - Remembers manual edits across executions
  • Sync - Automatically updates when inputs change, but preserves edits otherwise

Usage

Basic Workflow (Human Character)

[Character Prompt Builder - Female Person] or [Character Prompt Builder - Male Person]
      ↓
[Character Prompt Builder - Female Fashion] or [Character Prompt Builder - Male Fashion]
      ↓
[Character Prompt Builder - Female Actions] or [Character Prompt Builder - Male Actions]
      ↓
[Character Prompt Builder - Scene & Generate]
      ↓
(positive)
  • Choose Female Person or Male Person node based on your character
  • Match with the corresponding Fashion node (Female Fashion or Male Fashion)
  • The Action node is gender-specific (Female Actions or Male Actions)

Minimal Workflow

You can skip nodes you don't need:

[Female Person] or [Male Person] → [Scene & Generate]

or

[Female Person] or [Male Person] → [Female/Male Fashion] → [Scene & Generate]

or

[Female Person] or [Male Person] → [Female/Male Actions] → [Scene & Generate]

Connection Guide

  1. Add Character Prompt Builder - Female Person or Male Person node
  2. Connect settings output to matching Fashion node's settings_in
  3. Connect Fashion node's settings output to matching Female/Male Actions node's settings_in
  4. Connect Action node's settings output to Character Prompt Builder - Scene & Generate settings input
  5. Connect positive output to your sampler/CLIP nodes

Output Modes

Natural Language

Generates flowing, descriptive sentences:

A 25-year-old British woman. She has a slim build. Her face features bright blue eyes
and an oval-shaped face. Her hair is blonde, long, wavy. She wears a red silk slip dress.
Captured as a portrait. The scene is lit by golden hour light from the left.

Examples

Portrait Photography

Person: Woman, 28, Japanese, Slim
Fashion: Minimalist aesthetic, White blouse
Action: Sitting, looking away, serene
Scene: Close-up portrait, Natural sunlight, Golden hour

Editorial Fashion

Person: Man, 22, Brazilian, Athletic
Fashion: High Fashion aesthetic, Designer suit, Statement watch
Action: Walking, confident stride
Scene: Full body, Studio lighting, Fashion editorial pose

Troubleshooting

Nodes not appearing

  1. Restart ComfyUI completely
  2. Check the console for error messages
  3. Ensure the folder is in ComfyUI/custom_nodes/

Missing options in dropdowns

The node will auto-download character_prompt.json on first use. If this fails:

  1. Check your internet connection
  2. The file will be created in the resources folder
  3. Default options will be used as fallback

Credits

This project is forked from comfyui-easy-use.

Original Portrait Master created by:

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Changelog

v2.4.1

  • Optional Placement Poses - New hand, leg, and head placement options for more detailed pose control
  • Available in both Female Actions and Male Actions nodes
  • Scene node combines base pose with placement details in natural language

v2.4.0

  • Custom Character Sheet Panels - Choose 2, 3, or 4 panel layouts
  • New Render Styles - "3D cartoon illustration", "UE5 animated 3D render"
  • Restored features removed during previous refactor
  • Removed NSFW content

v2.3.0

  • Refactored data loading architecture with shared utilities module
  • Eliminated code duplication (~210 lines removed)
  • Improved maintainability with single source of truth

v2.2.0

  • Added Render Prompt Node for displaying and editing prompts

v2.1.0

  • Added new node for advanced facial expressions (e.g., "ecstatic", "melancholic")
  • Updated character_prompt.json with additional eye colors and hair styles
  • Improved settings merging logic in Scene node for better prompt flow
  • Refactored combo inputs to use updated JSON data loading
  • Enhanced natural language generation in Scene node to handle new settings keys
  • Fixed issue with default values in dropdowns not resetting properly
  • Fixed typo in "facial_expression" key usage

v2.0.0

  • Separate Male and Female Person Nodes - Gender-specific nodes with tailored options
  • Male-Specific Options - Body types, hairstyles, facial hair, fashion aesthetics, clothing
  • Facial Hair Support - 23 beard and mustache styles for male characters
  • Male Superhero Suits - Iron Man, Batman, Superman, Captain America, and more
  • Refactored Architecture - Nodes split into separate files for better maintainability
  • Gender Options - Woman/Girl for females, Man/Boy for males
  • Enforce Only Described Subjects - Option to prevent hallucination of extra characters

v1.1.0

  • Split Fashion node into separate Female and Male nodes
  • Added Action node for poses and actions
  • Updated workflow: Person → Female/Male Fashion → Action → Scene & Generate
  • Improved modularity and customization
  • Removed weighted prompt output; only natural language prompts are now generated

v1.0.0

  • Initial release
  • Three modular nodes: Person, Fashion, Scene
  • Natural language prompt output mode
  • Comprehensive portrait customization options
  • Location and environment settings