Upload 2 files

wildcard_2.py

@@ -0,0 +1,708 @@
+import random
+
+# ------------------------------------------------------------
+# WildcardCharacterPrompt
+#
+# Generates two character prompts from the same "base"
+# description:
+#   - 1girl variant
+#   - 1boy variant
+#
+# Structure of each prompt (comma-separated tokens):
+#
+#   Category 1 : "1girl" or "1boy"  (count + base gender, NEVER anything else)
+#   Category 2 : camera POV (8-ish logical directions, LEFTSIDE / RIGHTSIDE capitalized)
+#   Category 3 : "woman" / "man" / "girl" / "boy" / "grandma" / "grandpa" (age descriptor)
+#   Category 4 : two tokens: social type + inner personality
+#                both applied to Category 3 word:
+#                  "<social> <age-word>, <inner> <age-word>"
+#   Skin tone  : "<descriptor> skincolor"
+#   Category 5 : eyes:
+#                  "<color> eyes, <style> eyes, <look direction> eyes"
+#                (no eyewear)
+#   Category 6 : hair:
+#                  "<color> hair, <length> hair, <style> hair"
+#   Category 7 : top garment:
+#                  "<color> <top>, <material> <top>, <adjective> <top>"
+#   Category 8 : skirt:
+#                  "<color> skirt, <material> skirt, <adjective> skirt"
+#   Category 9 : bottom garment (pants/shorts/etc.):
+#                  "<color> <bottom>, <material> <bottom>, <adjective> <bottom>"
+#   Category 10: footwear:
+#                  "<color> <footwear>, <adjective> <footwear>, <adjective> <footwear>"
+#   Category 11: headwear:
+#                  "<color> <headwear> headwear"
+#
+# Precision > token cost > political correctness, tuned for literal image generators.
+# ------------------------------------------------------------
+
+class Wildcard_2:
+
+    @classmethod
+    def INPUT_TYPES(cls):
+        return {
+            "required": {
+                "seed": ("INT", {
+                    "default": 0,
+                    "min": -1,
+                    "max": 2**31 - 1,
+                    "step": 1
+                }),
+            },
+        }
+
+    RETURN_TYPES = ("STRING", "STRING")
+    RETURN_NAMES = ("female_prompt", "male_prompt")
+    FUNCTION = "generate"
+    CATEGORY = "prompt/wildcards"
+
+    # -----------------------------
+    # Core public entry point
+    # -----------------------------
+    def generate(self, seed: int):
+        # Seed handling:
+        #   seed >= 0  -> deterministic
+        #   seed  < 0  -> non-deterministic (system randomness)
+        if seed >= 0:
+            rng = random.Random(seed)
+        else:
+            rng = random.Random()
+
+        # Generate base traits once so male & female versions match
+        base_traits = self._generate_base_traits(rng)
+
+        female_prompt = self._build_prompt(base_traits, gender="female")
+        male_prompt   = self._build_prompt(base_traits, gender="male")
+
+        return (female_prompt, male_prompt)
+
+    # -----------------------------
+    # Base trait randomization
+    # -----------------------------
+    def _generate_base_traits(self, rng: random.Random) -> dict:
+        # Camera POV (LEFTSIDE / RIGHTSIDE in caps where used)
+        camera_povs = [
+            "straight-on",
+            "Frontview",
+            "Diagonal LEFTSIDE",
+            "Three Quarter View LEFTSIDE",
+            "Sideview LEFTSIDE",
+            "frontview POV",
+            "Sideview RIGHTSIDE",
+            "Three Quarter View RIGHTSIDE",
+        ]
+        camera_pov = rng.choice(camera_povs)
+
+        # Age bucket decides Category 3 word for each gender
+        age_buckets = ["young", "adult", "old"]
+        age_bucket = rng.choice(age_buckets)
+
+        # Social + inner personality traits (Category 4)
+        social_traits = [
+            "rich",
+            "high-class",
+            "middle-class",
+            "low-class",
+            "noble",
+            "royal",
+            "commoner",
+            "servant",
+            "outcast",
+            "scholar",
+            "warrior",
+            "mercenary",
+            "assassin",
+            "hunter",
+            "merchant",
+            "priestly",
+            "streetwise",
+            "criminal",
+        ]
+        inner_traits = [
+            "sadistic",
+            "kind",
+            "shy",
+            "cheerful",
+            "cold",
+            "calculating",
+            "lonely",
+            "obsessive",
+            "playful",
+            "stoic",
+            "anxious",
+            "confident",
+            "sarcastic",
+            "gentle",
+        ]
+        social_trait = rng.choice(social_traits)
+        inner_trait = rng.choice(inner_traits)
+
+        # Skin tones (avoid ambiguous 'colored' wording)
+        skin_tones = [
+            "very pale skincolor",
+            "fair skincolor",
+            "light tan skincolor",
+            "tan skincolor",
+            "olive skincolor",
+            "medium brown skincolor",
+            "dark brown skincolor",
+            "freckled skincolor",
+        ]
+        skin_tone = rng.choice(skin_tones)
+
+        # Eyes
+        eye_colors = [
+            "blue eyes",
+            "green eyes",
+            "grey eyes",
+            "brown eyes",
+            "hazel eyes",
+            "amber eyes",
+            "dark brown eyes",
+            "pale blue eyes",
+            "violet eyes",
+        ]
+        eye_styles = [
+            "sharp eyes",
+            "soft eyes",
+            "narrow eyes",
+            "wide eyes",
+            "sleepy eyes",
+            "intense eyes",
+            "cold eyes",
+            "warm eyes",
+            "round eyes",
+        ]
+        eye_directions = [
+            "",
+        ]
+        eye_color = rng.choice(eye_colors)
+        eye_style = rng.choice(eye_styles)
+        eye_direction = rng.choice(eye_directions)
+
+        # Hair (color, length, style)
+        hair_colors = [
+            "black hair",
+            "dark brown hair",
+            "brown hair",
+            "light brown hair",
+            "blonde hair",
+            "platinum blonde hair",
+            "ginger hair",         # use 'ginger' instead of 'red hair'
+            "silver hair",
+            "white hair",
+            "blue hair",
+            "pink hair",
+            "purple hair",
+        ]
+        hair_lengths = [
+            "very short hair",
+            "short hair",
+            "medium length hair",
+            "long hair",
+            "very long hair",
+            "waist-length hair",
+        ]
+        hair_styles = [
+            "straight hair",
+            "wavy hair",
+            "curly hair",
+            "messy hair",
+            "braided hair",
+            "spiky hair",
+            "neatly combed hair",
+        ]
+        hair_color = rng.choice(hair_colors)
+        hair_length = rng.choice(hair_lengths)
+        hair_style = rng.choice(hair_styles)
+
+        # Generic color palette for clothing and accessories
+        clothing_colors = [
+            "black",
+            "white",
+            "grey",
+            "brown",
+            "beige",
+            "red",
+            "blue",
+            "navy",
+            "green",
+            "yellow",
+            "purple",
+            "pink",
+        ]
+
+        # Top garment
+        top_types = [
+            "shirt",
+            "blouse",
+            "jacket",
+            "coat",
+            "sweater",
+            "hoodie",
+            "turtleneck",
+            "robe",
+            "vest",
+        ]
+        top_materials = [
+            "cotton",
+            "linen",
+            "silk",
+            "wool",
+            "leather",
+            "denim",
+            "canvas",
+        ]
+        top_adjectives = [
+            "simple",
+            "elegant",
+            "torn",
+            "baggy",
+            "tight",
+            "oversized",
+            "patterned",
+            "striped",
+            "checkered",
+            "decorated",
+            "embroidered",
+            "formal",
+            "casual",
+        ]
+        top_type = rng.choice(top_types)
+        top_color = rng.choice(clothing_colors)
+        top_material = rng.choice(top_materials)
+        top_adjective = rng.choice(top_adjectives)
+
+        # Skirt
+        skirt_colors = clothing_colors
+        skirt_materials = [
+            "cotton",
+            "linen",
+            "wool",
+            "silk",
+            "leather",
+            "denim",
+            "fur",
+        ]
+        skirt_adjectives = [
+            "short",
+            "knee-length",
+            "long",
+            "pleated",
+            "frilled",
+            "flowing",
+            "tight",
+            "dotted",
+            "checkered",
+            "patterned",
+        ]
+        skirt_color = rng.choice(skirt_colors)
+        skirt_material = rng.choice(skirt_materials)
+        skirt_adjective = rng.choice(skirt_adjectives)
+
+        # Bottom garment (pants / shorts / jeans / leggings, etc.)
+        bottom_types = [
+            "pants",
+            "trousers",
+            "jeans",
+            "shorts",
+            "leggings",
+        ]
+        bottom_materials = [
+            "cotton",
+            "linen",
+            "wool",
+            "denim",
+            "leather",
+            "synthetic",
+        ]
+        bottom_adjectives = [
+            "fluffy",
+            "baggy",
+            "tight",
+            "ripped",
+            "formal",
+            "casual",
+            "loose",
+            "high-waist",
+            "low-waist",
+        ]
+        bottom_type = rng.choice(bottom_types)
+        bottom_color = rng.choice(clothing_colors)
+        bottom_material = rng.choice(bottom_materials)
+        bottom_adjective = rng.choice(bottom_adjectives)
+
+        # Footwear
+        footwear_types = [
+            "boots",
+            "shoes",
+            "sneakers",
+            "sandals",
+            "high heels",
+            "loafers",
+        ]
+        footwear_adjectives = [
+            "long",          # works for boots (long boots)
+            "ankle-high",
+            "knee-high",
+            "lace-up",
+            "high-heeled",
+            "elegant",
+            "sturdy",
+            "worn",
+            "dirty",
+            "polished",
+        ]
+        footwear_type = rng.choice(footwear_types)
+        footwear_color = rng.choice(clothing_colors)
+        # ensure two different adjectives if possible
+        fw_adj1 = rng.choice(footwear_adjectives)
+        fw_adj2_options = [a for a in footwear_adjectives if a != fw_adj1]
+        fw_adj2 = rng.choice(fw_adj2_options) if fw_adj2_options else fw_adj1
+
+        # Headwear
+        headwear_types = [
+            "tiara",
+            "crown",
+            "hat",
+            "beret",
+            "beanie",
+            "headband",
+            "hood",
+            "helmet",
+            "cap",
+            "fedora",
+            "top hat",
+            "bowler hat",
+            "straw hat",
+            "sun hat",
+            "bucket hat",
+            "boater hat",
+            "panama hat",
+            "cloche hat",
+            "pillbox hat",
+            "fascinator",
+            "wide-brim hat",
+            "cowboy hat",
+            "sombrero",
+            "safari hat",
+            "pith helmet",
+            "trilby",
+            "newsboy cap",
+            "flat cap",
+            "ivy cap",
+            "driver cap",
+            "baseball cap",
+            "snapback cap",
+            "trucker cap",
+            "visor",
+            "sun visor",
+            "party cone hat",
+            "birthday hat",
+            "graduation cap",
+            "mortarboard",
+            "chef hat",
+            "toque",
+            "nurse cap",
+            "maid headband",
+            "sailor cap",
+            "military cap",
+            "officer cap",
+            "forage cap",
+            "garrison cap",
+            "tam o'shanter",
+            "deerstalker hat",
+            "ushanka",
+            "trapper hat",
+            "winter hat",
+            "knit cap",
+            "pom-pom beanie",
+            "ski cap",
+            "balaclava",
+            "hooded cloak",
+            "cowl hood",
+            "earmuffs",
+            "earflap hat",
+            "rain hat",
+            "oilskin hat",
+            "hard hat",
+            "construction helmet",
+            "miner helmet",
+            "bike helmet",
+            "motorcycle helmet",
+            "combat helmet",
+            "riot helmet",
+            "samurai helmet",
+            "horned helmet",
+            "viking helmet",
+            "roman helmet",
+            "spartan helmet",
+            "space helmet",
+            "astronaut helmet",
+            "pilot cap",
+            "flight helmet",
+            "aviator cap",
+            "swim cap",
+            "shower cap",
+            "sleeping cap",
+            "nightcap",
+            "veil",
+            "veiled hat",
+            "lace headscarf",
+            "headscarf",
+            "bandana",
+            "kerchief",
+            "turban",
+            "keffiyeh",
+            "wrapped headscarf",
+            "flower crown",
+            "floral wreath",
+            "leaf crown",
+            "laurel wreath",
+            "circlet",
+            "halo headband",
+            "sports headband",
+            "sweatband",
+            "visor cap",
+            "wizard hat",
+            "witch hat",
+            "magician hat",
+            "jester hat",
+            "animal-ear headband",
+            "horn headband",
+            "antenna headband",
+            "visor",
+            "sunhat",
+            "fedora",
+            "bowler hat",
+            "top hat",
+            "trilby",
+            "bucket hat",
+            "boater hat",
+            "newsboy cap",
+            "flat cap",
+            "snapback cap",
+            "baseball cap",
+            "cowboy hat",
+            "wide-brim hat",
+            "straw hat",
+            "panama hat",
+            "safari hat",
+            "rain hat",
+            "fur hat",
+            "ushanka hat",
+            "ski cap",
+            "earflap hat",
+            "turban",
+            "headscarf",
+            "bandana",
+            "kerchief",
+            "hooded cloak",
+            "wizard hat",
+            "witch hat",
+            "party hat",
+            "chef hat",
+            "nurse cap",
+            "military cap",
+            "officer cap",
+            "combat helmet",
+            "biker helmet",
+            "space helmet",
+            "pilot cap",
+            "aviator helmet",
+            "construction helmet",
+            "hard hat",
+            "diving helmet",
+            "knight helmet",
+            "samurai helmet",
+            "viking helmet",
+            "horned helmet",
+            "circlet",
+            "laurel wreath",
+            "flower crown",
+            "veil",
+            "bridal veil",
+            "fascinator",
+            "pillbox hat",
+            "cloche hat",
+            "mob cap",
+            "nightcap",
+            "sleeping cap",
+            "sailor cap",
+            "conductor cap",
+            "police cap",
+            "firefighter helmet",
+            "ranger hat",
+            "tactical helmet",
+            "bike helmet",
+            "sports visor",
+            "golf cap",
+            "hunting cap",
+            "trapper hat",
+            "tam o'shanter",
+            "deerstalker hat",
+            "santa hat",
+            "jester hat",
+            "carnival mask",
+            "masquerade mask",
+            "plague doctor mask",
+            "gas mask",
+            "earmuffs",
+            "cowl",
+            "balaclava",
+            "ski mask",
+            "hooded scarf",
+            "head wrap",
+            "shawl hood",
+            "animal hood",
+            "wolf hood",
+            "cat ear headband",
+            "bear ear headband",
+            "devil horn headband",
+            "bunny ear headband",
+            "antenna headband",
+            "spiked crown",
+            "metal halo",
+            "glowing halo",
+            "tiara crown",
+            "opera hat",
+            "feathered hat",
+            "fur hood",
+            "rain hood",
+            "straw bonnet",
+            "bonnet",
+        ]
+        headwear_color = rng.choice(clothing_colors)
+        headwear_type = rng.choice(headwear_types)
+
+        return {
+            "camera_pov": camera_pov,
+            "age_bucket": age_bucket,
+            "social_trait": social_trait,
+            "inner_trait": inner_trait,
+            "skin_tone": skin_tone,
+            "eye_color": eye_color,
+            "eye_style": eye_style,
+            "eye_direction": eye_direction,
+            "hair_color": hair_color,
+            "hair_length": hair_length,
+            "hair_style": hair_style,
+            "top_color": top_color,
+            "top_material": top_material,
+            "top_adjective": top_adjective,
+            "top_type": top_type,
+            "skirt_color": skirt_color,
+            "skirt_material": skirt_material,
+            "skirt_adjective": skirt_adjective,
+            "bottom_color": bottom_color,
+            "bottom_material": bottom_material,
+            "bottom_adjective": bottom_adjective,
+            "bottom_type": bottom_type,
+            "footwear_color": footwear_color,
+            "footwear_type": footwear_type,
+            "footwear_adj1": fw_adj1,
+            "footwear_adj2": fw_adj2,
+            "headwear_color": headwear_color,
+            "headwear_type": headwear_type,
+        }
+
+    # -----------------------------
+    # Prompt assembly
+    # -----------------------------
+    def _build_prompt(self, base: dict, gender: str) -> str:
+        # gender: "female" or "male"
+        assert gender in ("female", "male")
+
+        # Category 1: "1girl" or "1boy"
+        if gender == "female":
+            cat1 = "1girl"
+        else:
+            cat1 = "1boy"
+
+        # Category 3: age word ("woman"/"man"/"girl"/"boy"/"grandma"/"grandpa")
+        age_bucket = base["age_bucket"]
+        if gender == "female":
+            if age_bucket == "young":
+                age_word = "girl"
+            elif age_bucket == "adult":
+                age_word = "woman"
+            else:
+                age_word = "loli"
+        else:
+            if age_bucket == "young":
+                age_word = "boy"
+            elif age_bucket == "adult":
+                age_word = "man"
+            else:
+                age_word = "shota"
+
+        # Category 4: social + inner personality descriptors that use the age_word
+        social_token = f"{base['social_trait']} {age_word}"
+        inner_token = f"{base['inner_trait']} {age_word}"
+
+        # Category 5: eyes (color, style, direction)
+        eye_color = base["eye_color"]                  # already contains "eyes"
+        eye_style = base["eye_style"]                  # already contains "eyes"
+        eye_direction = base["eye_direction"]          # already contains "eyes"
+
+        # Category 6: hair
+        hair_color = base["hair_color"]
+        hair_length = base["hair_length"]
+        hair_style = base["hair_style"]
+
+        # Category 7: top garment
+        top_color = f"{base['top_color']} {base['top_type']}"
+        top_material = f"{base['top_material']} {base['top_type']}"
+        top_adjective = f"{base['top_adjective']} {base['top_type']}"
+
+        # Category 8: skirt
+        skirt_color = f"{base['skirt_color']} skirt"
+        skirt_material = f"{base['skirt_material']} skirt"
+        skirt_adjective = f"{base['skirt_adjective']} skirt"
+
+        # Category 9: bottom garment (pants etc.)
+        bottom_color = f"{base['bottom_color']} {base['bottom_type']}"
+        bottom_material = f"{base['bottom_material']} {base['bottom_type']}"
+        bottom_adjective = f"{base['bottom_adjective']} {base['bottom_type']}"
+
+        # Category 10: footwear
+        footwear_color = f"{base['footwear_color']} {base['footwear_type']}"
+        footwear_adj1 = f"{base['footwear_adj1']} {base['footwear_type']}"
+        footwear_adj2 = f"{base['footwear_adj2']} {base['footwear_type']}"
+
+        # Category 11: headwear
+        headwear = f"{base['headwear_color']} {base['headwear_type']} headwear"
+
+        # Assemble all tokens in the logical order of your template
+        tokens = [
+            cat1,                                  # Category 1
+            base["camera_pov"],                    # Category 2
+            age_word,                              # Category 3
+            social_token,                          # Category 4 (social)
+            inner_token,                           # Category 4 (inner)
+            base["skin_tone"],                     # skincolor descriptor
+            eye_color, eye_style, eye_direction,   # Category 5
+            hair_color, hair_length, hair_style,   # Category 6
+            top_color, top_material, top_adjective,  # Category 7
+            skirt_color, skirt_material, skirt_adjective,  # Category 8
+            bottom_color, bottom_material, bottom_adjective,  # Category 9
+            footwear_color, footwear_adj1, footwear_adj2,  # Category 10
+            headwear,                              # Category 11
+        ]
+
+        # Join tokens into a single prompt
+        prompt = ", ".join(tokens) + "."
+        return prompt
+
+
+# ------------------------------------------------------------
+# ComfyUI node registration
+# ------------------------------------------------------------
+
+NODE_CLASS_MAPPINGS = {
+    "Wildcard_2": Wildcard_2,
+}
+
+NODE_DISPLAY_NAME_MAPPINGS = {
+    "Wildcard_2": "Wildcard_2",
+}

wildcard_4.py

@@ -0,0 +1,535 @@
+import random
+
+class Wildcard_4:
+    """
+    ComfyUI custom node:
+    Takes a seed and generates a pair of matching wildcard prompts:
+    - one female-focused ("1girl")
+    - one male-focused ("1boy")
+    """
+
+    @classmethod
+    def INPUT_TYPES(cls):
+        return {
+            "required": {
+                "seed": ("INT", {
+                    "default": 0,
+                    "min": 0,
+                    "max": 0x7FFFFFFF,
+                    "step": 1,
+                }),
+            },
+        }
+
+    RETURN_TYPES = ("STRING", "STRING",)
+    RETURN_NAMES = ("female_prompt", "male_prompt",)
+    FUNCTION = "generate"
+    CATEGORY = "wildcards/prompt"
+
+    # -------- core random building blocks --------
+
+    def _select_age_group(self, rng: random.Random):
+        # young / adult / elder - affects the noun in category 3
+        return rng.choice(["young", "adult", "kid"])
+
+    def _age_noun(self, variant: str, age_group: str) -> str:
+        # variant: "female" or "male"
+        if variant == "female":
+            if age_group == "young":
+                return "girl"
+            elif age_group == "kid":
+                return "loli"
+            else:
+                return "woman"
+        else:
+            if age_group == "young":
+                return "boy"
+            elif age_group == "kid":
+                return "shota"
+            else:
+                return "man"
+
+    def _camera_pov(self, rng: random.Random) -> str:
+        # Category 2: POV of camera – 8 directions, LEFTSIDE/RIGHTSIDE in caps
+        pov_options = [
+            "straight-on",
+            "diagonal LEFTSIDE",
+            "sideview LEFTSIDE",
+            "straight-on",
+            "sideview RIGHTSIDE",
+            "diagonal RIGHTSIDE",
+            "low-angle view from below",
+        ]
+        return rng.choice(pov_options)
+
+    def _skincolor(self, rng: random.Random) -> str:
+        # No "colored skincolor" nonsense; purely descriptive
+        options = [
+            "porcelain skincolor",
+            "pale skincolor",
+            "fair skincolor",
+            "light brown skincolor",
+            "sun-kissed tan skincolor",
+            "olive skincolor",
+            "warm brown skincolor",
+            "deep brown skincolor",
+            "ashen grey skincolor",
+            "golden bronze skincolor",
+        ]
+        return rng.choice(options)
+
+    def _eyes(self, rng: random.Random):
+        # Category 5: eyecolor, eye-style, look direction – always with "eyes"
+        eye_colors = [
+            "blue", "green", "hazel", "amber",
+            "grey", "violet", "golden", "turquoise",
+        ]
+        eye_styles = [
+            "sharp gaze",
+            "cold gaze",
+            "soft gaze",
+            "tired gaze",
+            "glowing gaze",
+            "mysterious gaze",
+            "intense gaze",
+            "dreamy gaze",
+        ]
+        eye_directions = [
+            "",
+        ]
+        color = rng.choice(eye_colors)
+        style = rng.choice(eye_styles)
+        direction = rng.choice(eye_directions)
+        return [
+            f"{color} eyes",
+            f"{style} eyes",
+            f"{direction} eyes",
+        ]
+
+    def _hair(self, rng: random.Random):
+        # Category 6: hair (color, length, hairstyle), note: no "red hair" – use "ginger"
+        hair_colors = [
+            "black",
+            "white",
+            "silver",
+            "ginger",
+            "copper",
+            "dark brown",
+            "chestnut",
+            "platinum blonde",
+            "strawberry blonde",
+            "midnight blue",
+            "lavender",
+        ]
+        hair_lengths = [
+            "very short",
+            "short",
+            "shoulder-length",
+            "long",
+            "very long",
+            "waist-length",
+            "ankle-length",
+        ]
+        hair_styles = [
+            "straight",
+            "wavy",
+            "curly",
+            "messy",
+            "braided",
+            "twin braids",
+            "high ponytail",
+            "low ponytail",
+            "intricate updo",
+            "windswept",
+            "spiky",
+        ]
+        color = rng.choice(hair_colors)
+        length = rng.choice(hair_lengths)
+        style = rng.choice(hair_styles)
+        return [
+            f"{color} hair",
+            f"{length} hair",
+            f"{style} hair",
+        ]
+
+    def _top_garment(self, rng: random.Random):
+        # Category 7: top garment – color, material, descriptive adjective; same noun
+        garment_nouns = [
+            # basic tops
+            "shirt",
+            "t-shirt",
+            "tank top",
+            "crop top",
+            "blouse",
+            "dress shirt",
+            "polo shirt",
+            "long-sleeve shirt",
+            # fitted / structured
+            "vest",
+            "waistcoat",
+            "bodice",
+            "corset",
+            # knitwear
+            "sweater",
+            "jumper",
+            "cardigan",
+            "pullover",
+            "sweatshirt",
+            "hoodie",
+            # loose / draped
+            "poncho",
+            "tunic",
+            "smock",
+            # robes & kimonos
+            "kimono",
+            "haori",
+            "robe",
+            "cloak",
+            "cape",
+            # jackets & coats
+            "jacket",
+            "denim jacket",
+            "leather jacket",
+            "bomber jacket",
+            "biker jacket",
+            "puffer jacket",
+            "parka",
+            "trench coat",
+            "overcoat",
+            "coat",
+            "pea coat",
+            # fantasy / historical
+            "doublet",
+            "tabard",
+            "jersey",
+            "sports jersey",
+            "armor vest",
+            "breastplate",
+            "armor top",
+        ]
+        colors = [
+            "red", "crimson", "blue", "navy", "emerald",
+            "black", "white", "grey", "brown", "tan",
+            "purple", "royal purple", "teal",
+        ]
+        materials = [
+            "linen", "silk", "velvet", "cotton",
+            "leather", "chainmail", "satin", "wool",
+            "dragon-scale", "enchanted silk",
+        ]
+        descriptors = [
+            "torn", "ornate", "simple", "elegant",
+            "battle-worn", "embroidered", "loose",
+            "tight-fitting", "ceremonial", "casual",
+            "fancy", "royal",
+        ]
+        noun = rng.choice(garment_nouns)
+        color = rng.choice(colors)
+        material = rng.choice(materials)
+        descriptor = rng.choice(descriptors)
+        return [
+            f"{color} {noun}",
+            f"{material} {noun}",
+            f"{descriptor} {noun}",
+        ]
+
+    def _skirt(self, rng: random.Random):
+        # Category 8: skirt – always skirt, color + length + descriptor
+        colors = [
+            "black", "brown", "white", "grey", "navy",
+            "deep red", "forest green", "midnight blue",
+            "burgundy", "ivory",
+        ]
+        lengths = [
+            "short", "knee-length", "mid-length",
+            "long", "floor-length",
+        ]
+        descriptors = [
+            "pleated", "ruffled", "fur", "layered",
+            "dotted", "striped", "checkered",
+            "embroidered", "shimmering", "tattered",
+        ]
+        color = rng.choice(colors)
+        length = rng.choice(lengths)
+        descriptor = rng.choice(descriptors)
+        return [
+            f"{color} skirt",
+            f"{length} skirt",
+            f"{descriptor} skirt",
+        ]
+
+    def _bottoms(self, rng: random.Random):
+        # Category 9: any bottom garment – but consistent noun
+        garment_nouns = [
+            # pants & trousers
+            "pants",
+            "trousers",
+            "jeans",
+            "skinny jeans",
+            "cargo pants",
+            "sweatpants",
+            "track pants",
+            "yoga pants",
+            "chinos",
+            "slacks",
+            "dress pants",
+            "khaki pants",
+            "work pants",
+            # tight legwear
+            "leggings",
+            "tights",
+            "stockings",
+            # shorts
+            "shorts",
+            "denim shorts",
+            "bike shorts",
+            "running shorts",
+            # cropped / alternative cuts
+            "capris",
+            "breeches",
+            "riding pants",
+            "hakama",
+            "culottes",
+            "joggers",
+            # fantasy / armor
+            "battle greaves",
+        ]
+        colors = [
+            "black", "dark brown", "grey", "charcoal",
+            "olive", "navy", "sand-colored",
+        ]
+        materials = [
+            "leather", "denim", "wool", "linen",
+            "padded", "scale-plated",
+        ]
+        descriptors = [
+            "tailored", "baggy", "fluffy", "fitted",
+            "torn", "patched", "armored",
+        ]
+        noun = rng.choice(garment_nouns)
+        color = rng.choice(colors)
+        material = rng.choice(materials)
+        descriptor = rng.choice(descriptors)
+        return [
+            f"{color} {noun}",
+            f"{material} {noun}",
+            f"{descriptor} {noun}",
+        ]
+
+    def _footwear(self, rng: random.Random):
+        # Category 10: any footwear – color + two styles, same base noun
+        shoe_nouns = [
+            "boots",
+            "shoes",
+            "sandals",
+            "riding boots",
+            "combat boots",
+            "high-heeled boots",
+        ]
+        colors = [
+            "black", "dark brown", "grey", "white",
+            "red", "crimson", "navy", "forest green",
+        ]
+        styles = [
+            "long", "knee-high", "ankle", "lace-up",
+            "fur-lined", "armored", "worn", "polished",
+            "buckled",
+        ]
+        noun = rng.choice(shoe_nouns)
+        color = rng.choice(colors)
+        style1, style2 = rng.sample(styles, 2)
+        return [
+            f"{color} {noun}",
+            f"{style1} {noun}",
+            f"{style2} {noun}",
+        ]
+
+    def _headwear(self, rng: random.Random):
+        # HEADWEAR: color + thing + literal word "headwear" at the end
+        headpieces = [
+            # caps & casual
+            "cap",
+            "baseball cap",
+            "beanie",
+            "knit cap",
+            "watch cap",
+            "newsboy cap",
+            "flat cap",
+            # hats
+            "bucket hat",
+            "sun hat",
+            "wide-brim hat",
+            "straw hat",
+            "boater hat",
+            "panama hat",
+            "fedora",
+            "trilby",
+            "top hat",
+            "bowler hat",
+            "cowboy hat",
+            "sombrero",
+            "fur hat",
+            "ushanka",
+            # sport / utility
+            "visor",
+            "headband",
+            "bandana",
+            "balaclava",
+            # hoods & helmets
+            "hood",
+            "cloak hood",
+            "helmet",
+            "combat helmet",
+            "riding helmet",
+            "steel helm",
+            "open-face helm",
+            "closed helm",
+            "coif",
+            # crowns etc
+            "circlet",
+            "tiara",
+            "crown",
+            "laurel wreath",
+            "flower crown",
+            # veils / scarves
+            "veil",
+            "headscarf",
+            "kerchief",
+            # fantasy
+            "witch hat",
+            "wizard hat",
+            "officer cap",
+        ]
+        colors = [
+            "black", "silver", "gold", "dark-grey",
+            "white", "red", "purple", "green",
+        ]
+        color = rng.choice(colors)
+        piece = rng.choice(headpieces)
+        return f"{color} {piece} headwear"
+
+    def _social_inner_traits(self, rng: random.Random):
+        # Category 4: outer/social & inner personality
+        social_traits = [
+            "rich",
+            "noble",
+            "royal",
+            "streetwise",
+            "mysterious",
+            "famous",
+            "feared",
+            "holy",
+            "cursed",
+            "arcane",
+        ]
+        inner_traits = [
+            "kind",
+            "melancholic",
+            "sadistic",
+            "playful",
+            "arrogant",
+            "stoic",
+            "cold-blooded",
+            "gentle",
+            "obsessive",
+            "scheming",
+        ]
+        social = rng.choice(social_traits)
+        inner = rng.choice(inner_traits)
+        if inner == social:
+            # ensure two distinct traits
+            inner = rng.choice([t for t in inner_traits if t != social])
+        return social, inner
+
+    def _build_shared_description(self, rng: random.Random):
+        """
+        Use one RNG to build *shared* visual traits.
+        Gender-specific bits are applied later so male/female
+        prompts stay in sync.
+        """
+        age_group = self._select_age_group(rng)
+        pov = self._camera_pov(rng)
+        social, inner = self._social_inner_traits(rng)
+        skin = self._skincolor(rng)
+        eyes = self._eyes(rng)
+        hair = self._hair(rng)
+        top = self._top_garment(rng)
+        skirt = self._skirt(rng)
+        bottoms = self._bottoms(rng)
+        footwear = self._footwear(rng)
+        headwear = self._headwear(rng)
+
+        return {
+            "age_group": age_group,
+            "pov": pov,
+            "social_trait": social,
+            "inner_trait": inner,
+            "skin": skin,
+            "eyes": eyes,
+            "hair": hair,
+            "top": top,
+            "skirt": skirt,
+            "bottoms": bottoms,
+            "footwear": footwear,
+            "headwear": headwear,
+        }
+
+    def _build_prompt_from_shared(self, shared: dict, variant: str) -> str:
+        assert variant in ("female", "male")
+        age_group = shared["age_group"]
+        pov = shared["pov"]
+        social_trait = shared["social_trait"]
+        inner_trait = shared["inner_trait"]
+
+        age_noun = self._age_noun(variant, age_group)
+
+        # Category 1: gender count (always 1girl / 1boy)
+        cat1 = "1girl" if variant == "female" else "1boy"
+
+        # Category 2: camera POV
+        cat2 = pov
+
+        # Category 3: age noun (woman / man / girl / boy / grandma / grandpa)
+        cat3 = age_noun
+
+        # Category 4: social + inner traits, both reuse age_noun as second word
+        cat4_1 = f"{social_trait} {age_noun}"
+        cat4_2 = f"{inner_trait} {age_noun}"
+
+        parts = []
+        parts.append(cat1)
+        parts.append(cat2)
+        parts.append(cat3)
+        parts.append(cat4_1)
+        parts.append(cat4_2)
+        parts.append(shared["skin"])
+        parts.extend(shared["eyes"])
+        parts.extend(shared["hair"])
+        parts.extend(shared["top"])
+        parts.extend(shared["skirt"])
+        parts.extend(shared["bottoms"])
+        parts.extend(shared["footwear"])
+        parts.append(shared["headwear"])
+
+        return ", ".join(parts)
+
+    # -------- main entrypoint --------
+
+    def generate(self, seed: int):
+        rng = random.Random(int(seed))
+
+        shared = self._build_shared_description(rng)
+        female_prompt = self._build_prompt_from_shared(shared, "female")
+        male_prompt = self._build_prompt_from_shared(shared, "male")
+
+        return (female_prompt, male_prompt,)
+
+
+# ComfyUI registration
+NODE_CLASS_MAPPINGS = {
+    "Wildcard_4": Wildcard_4,
+}
+
+NODE_DISPLAY_NAME_MAPPINGS = {
+    "Wildcard_4": "Wildcard_4",
+}