Extensions/ComfyUI-HumanComposer
ComfyUI Extension

ComfyUI-HumanComposer

A ComfyUI node for creating human character prompts with guided fields for gender, age, ethnicity, body type, hair, clothing, accessories, pose, camera, lighting, and art style. (Description by CC)

By max-dingsda·Created about a month ago·Updated about a month ago· 12
max-dingsda/ComfyUI-HumanComposer
Nodes1
On cloudLocal install
CategoryHuman Composer
Stars12
Updatedabout a month ago
Readme

Human Composer

This is a ComfyUI-node for all the people who are like me. I often want to build human characters but since I'm not a native english speaker I lack the right words. Instead of keeping lists with keywords, I put those I considered the most important into this node...it has its flaws but to me it's a great help...and if you use a "Preview as Text"-node, you can just copy the composition and continue with your very individual setup.

The result is Human Composer: a ComfyUI node that turns "describe a person" into a guided checklist — gender, age, ethnicity, body type, nine independent hair dimensions, full clothing composition, accessories, pose, camera, lighting, art style — so you stop forgetting the details that make a character believable, and start getting consistent, reproducible results.

No LLM, no API keys, no extra dependencies. Pick from dropdowns (or type your own custom value per field), and the node renders a ready-to-use prompt in the format your checkpoint actually wants.

Why you'll like it

  • Nothing gets forgotten. ~30 fields grouped by subject, appearance, hair, clothing, accessories, scene, and camera — the categories people typically only think of after the first bad generation.
  • Speaks your checkpoint's language. One flip of output_format switches between a structured label list, comma-separated tags, a natural-language sentence, or Pony-style score tags — no manual reformatting.
  • Flexible when presets aren't enough. Every field has a Custom value… option with its own text box, plus a free-form additional_details field for anything not covered.
  • Empty stays empty. Fields left at — not set — are simply skipped — no dangling labels or empty tags in your prompt.

Output formats

| Format | Best for | Example | | --- | --- | --- | | SDXL – Structured | SDXL checkpoints that like readable, labeled blocks | Gender: woman, Hair Style: ponytail | | SDXL – Comma Tags | Danbooru-style / tag-trained checkpoints | woman, ponytail, red hair, beach | | FLUX – Natural Prompt | FLUX and other natural-language models | A woman with ... The person has ponytail and red hair. Beach. | | Pony – Comma Tags | Pony Diffusion and derivatives | score_9, score_8_up, score_7_up, woman, ... |

How to use it

  1. Install the node (see below) and restart ComfyUI.
  2. Add Human Composer Prompt Builder to your workflow (category: Human Composer).
  3. Pick an output_format matching your checkpoint.
  4. Fill in as many or as few fields as you like — leave the rest at — not set —.
  5. Need something not in the list? Set that field to Custom value… and type it in the field right next to it, or drop it into additional_details.
  6. Connect the prompt output to your CLIP Text Encode node's text input, and queue your prompt as usual.

Installation

Clone into ComfyUI/custom_nodes/:

git clone https://github.com/max-dingsda/ComfyUI-HumanComposer

Restart ComfyUI. No extra dependencies required.