From 3d88414cde5e4f7c6c17388a86369e28b8a7a978 Mon Sep 17 00:00:00 2001
From: BRADSEC <7948876+bradsec@users.noreply.github.com>
Date: Sun, 21 Jun 2026 20:04:15 +1000
Subject: [PATCH] docs: document segment nodes and body attributes; bump 1.1.0

---
 README.md      | 18 +++++++++++++++---
 pyproject.toml |  4 ++--
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index ca78ccf..7782146 100644
--- a/README.md
+++ b/README.md
@@ -6,9 +6,18 @@ Generates a randomised, structured physical description of a person to drop stra
 
 ## Purpose
 
-When a prompt leaves appearance vague, diffusion models fall back on a narrow set of "default" faces, so every person in a batch looks the same. This node supplies a specific, well-formed description on each run, covering nationality, age, complexion and skin texture, eye colour and shape, eyebrows, face shape and distinctive features, hair, facial hair, build, expression, accessories, and makeup. Varying those traits per seed pushes the model off its defaults toward distinct, individual people. Lock the traits you care about, let the rest randomise.
+When a prompt leaves appearance vague, diffusion models fall back on a narrow set of "default" faces, so every person in a batch looks the same. This node supplies a specific, well-formed description on each run, covering nationality, age, complexion and skin texture, eye colour and shape, eyebrows, face shape and distinctive features, hair, facial hair, build, shoulders, chest or bust, expression, accessories, and makeup. Varying those traits per seed pushes the model off its defaults toward distinct, individual people. Lock the traits you care about, let the rest randomise.
 
-The node will be located under **Add Node > utils**. Node name: **Random Person Description**.
+The nodes appear in the **Add Node** menu under **Random Person**:
+
+- **Random Person Description** - the full node, every attribute on one node.
+- **Random Person: Identity** - sex, age, nationality, complexion, skin texture.
+- **Random Person: Face & Expression** - face shape, eyes, eyebrows, nose, mouth, distinctive features, expression.
+- **Random Person: Hair** - hair colour, style, length, facial hair.
+- **Random Person: Body** - build, shoulders, chest, bust size and shape.
+- **Random Person: Style** - accessories and makeup.
+
+The segment nodes are independent generators: each has its own seed and sex and emits its group's fragment. Concatenate the `description` outputs with any string node to assemble a full prompt.
 
 **Example output (male):**
 ```
@@ -32,7 +41,7 @@ In ComfyUI, open **Manager > Custom Nodes Manager**, search for **ComfyUI_Random
 1. Copy the `ComfyUI_RandomPerson` folder into your `ComfyUI/custom_nodes/` directory
 2. Restart ComfyUI
 
-The node appears in the **Add Node** menu under **utils > Random Person Description**.
+The nodes appear in the **Add Node** menu under **Random Person**.
 
 ---
 
@@ -49,6 +58,9 @@ The node appears in the **Add Node** menu under **utils > Random Person Descript
 | `hair` | Combined hair description | `red very short hair worn twist out` |
 | `facial_hair` | Beard / moustache style (empty for clean shaven) | `a van dyke beard` |
 | `body_type` | Build | `muscular` |
+| `shoulders` | Shoulder descriptor (empty when off) | `broad shoulders` |
+| `chest` | Chest descriptor, male (empty when off / female) | `a muscular chest` |
+| `bust` | Combined bust size and shape, female (empty when off / male) | `a full, round bust` |
 | `expression` | Facial expression (empty for neutral) | `a soft smile` |
 | `accessories` | Eyewear / jewellery (empty for none) | `reading glasses` |
 | `makeup` | Makeup style (empty for none / male) | `bold lipstick` |
diff --git a/pyproject.toml b/pyproject.toml
index cd5fe4e..f57ce03 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,7 +1,7 @@
 [project]
 name = "comfyui_randomperson"
-description = "Generate randomised, structured physical person descriptions for image-generation prompts. Sex-aware traits, per-category random/allow_list/fixed/off modes, age ranges, and individual output pins. Located under Add Node > utils. Node name: Random Person Description."
-version = "1.0.8"
+description = "Generate randomised, structured physical person descriptions for image-generation prompts. Sex-aware traits, per-category random/allow_list/fixed/off modes, age ranges, body details, and individual output pins. Full node plus Identity, Face, Hair, Body, and Style segment nodes under the Random Person menu category."
+version = "1.1.0"
 license = { file = "LICENSE" }
 requires-python = ">=3.10"
 dependencies = []