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

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
🚀 Spaceship & Vehicle Builder - Design spaceships with weapons, shields, and modifications
📸 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: ComfyUI Manager (Recommended)

Open ComfyUI Manager
Search for "Character Prompt Builder"
Click Install

Method 2: Git Clone

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

Method 3: Manual Download

Download the latest release
Extract to ComfyUI/custom_nodes/comfyui-character-prompt-builder
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 - Spaceship Character

Controls spaceship/vehicle design and appearance:

| Category | Options | | ----------------- | ---------------------------------------------------------- | | Identity | Style reference, type, size, faction | | Appearance | Design style, condition, primary color, accent color | | Propulsion | Propulsion type, engine glow color | | Wings | Count, type, position, vertical stabilizers, canard wings | | Engines | Count, placement, configuration | | Hull | Fuselage shape, hull structure, surface texture, symmetry | | Cockpit | Type, lighting | | Markings | Running lights, markings, decal style | | Operations | Landing gear, canopy type, crew capacity, gear deployment |

⚔️ Character Prompt Builder - Spaceship Mods

Controls weapons and modifications for spaceships:

| Category | Options | | ------------------ | ------------------------------------------------ | | Weapons | 3 weapon system slots | | Defense | Shield system, armor plating, cloaking device | | Utility | Cargo capacity, sensors, communications, tractor beam | | Special | 3 special feature slots |

📸 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)

Spaceship Workflow

[Character Prompt Builder - Spaceship Character]
      ↓
[Character Prompt Builder - Spaceship Mods] (optional)
      ↓
[Character Prompt Builder - Scene & Generate]
      ↓
(positive)

Minimal Workflow

You can skip nodes you don't need:

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

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

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

Connection Guide

Add Character Prompt Builder - Female Person or Male Person node
Connect settings output to matching Fashion node's settings_in
Connect Fashion node's settings output to matching Female/Male Actions node's settings_in
Connect Action node's settings output to Character Prompt Builder - Scene & Generate settings input
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

Restart ComfyUI completely
Check the console for error messages
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:

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

Credits

This project is forked from comfyui-easy-use.

Original Portrait Master created by:

AI Wiz Art (Stefano Flore) - stefanoflore.it | ai-wiz.art

License

MIT License - see LICENSE for details.

Contributing

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

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
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

Spaceship Character Nodes - Design spaceships with weapons, shields, modifications
Custom Character Sheet Panels - Choose 2, 3, or 4 panel layouts
New Render Styles - "3D cartoon illustration", "UE5 animated 3D render"
Space Environment Options - Space-specific lighting and environments
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