comfyui-portrait-master

ComfyUI Portrait Master

A comprehensive custom node for ComfyUI designed to help AI image creators generate detailed and professional prompts for human portraits. This powerful tool provides modular control over every aspect of portrait generation, from basic character features to advanced skin details and styling options.

🌟 Features

Modular Node System

• Portrait Master: Base Character - Core character attributes (gender, age, nationality, body type, facial features)
• Portrait Master: Skin Details - Advanced skin rendering controls (pores, imperfections, natural skin effects)
• Portrait Master: Style & Pose - Lighting, poses, clothing, and artistic styles
• Portrait Master: Make-up - Comprehensive makeup options with color controls
• Portrait Master: Face Generator - Simplified face generation for quick results
• Portrait Master: Prompt Styler - Converts weighted prompts to conversational style for modern models

Advanced Features

• Preset System - Save and load your favorite configurations across all nodes
• Random Generation - Built-in randomization for creative exploration
• Weight Control - Fine-tune the influence of each parameter
• Nationality Mixing - Blend multiple ethnicities with precise control
• Comprehensive Lists - Over 1000+ options across all categories

Extensive Options Library

• 192 Nationalities - Complete global coverage
• 65+ Artistic Styles - From vintage photography to modern effects
• 100+ Hair Styles - Comprehensive hair options
• 70+ Lighting Types - Professional lighting setups
• 87+ Model Poses - Diverse pose library
• And much more - Eyes, lips, makeup, clothing, expressions, and body types

📋 Requirements

• ComfyUI - Latest version recommended
• Python 3.8+ - Required for ComfyUI
• Compatible Models - Works with SD1.5, SDXL, Flux, and other modern checkpoints
• Optional Dependencies:
  • ComfyUI Manager - For easy installation
  • ComfyUI Prompt Control - For nationality mixing syntax

🚀 Installation

Method 1: ComfyUI Manager (Recommended)

1. Open ComfyUI Manager
2. Search for florestefano1975 in the search bar
3. Click the install button for "ComfyUI Portrait Master"
4. Restart ComfyUI

Method 2: Manual Installation

1. Navigate to your ComfyUI custom_nodes folder
2. Open terminal/command prompt in this directory
3. Run: git clone https://github.com/florestefano1975/comfyui-portrait-master
4. Restart ComfyUI

Method 3: Manual Update

To update an existing installation:

1. Navigate to the comfyui-portrait-master folder
2. Run: git pull
3. Restart ComfyUI

⚠️ Warning: The update command will overwrite any custom modifications you've made to the files.

📖 Usage Guide

Basic Workflow

1. Add Base Character Node - Start with PortraitMasterBaseCharacter for core features
2. Chain Additional Nodes - Connect PortraitMasterSkinDetails, PortraitMasterStylePose, etc.
3. Configure Parameters - Adjust sliders and dropdowns to your preferences
4. Connect to Prompt - Link the final output to your CLIPTextEncode node
5. Generate - Run your workflow to create detailed portrait prompts

Node Descriptions

Portrait Master: Base Character

Controls fundamental character attributes:

• Shot Types: Head portrait, full body, close-up, etc.
• Demographics: Gender, age, nationality with mixing support
• Physical Features: Body type, breast/butt size, facial features
• Hair & Beard: Style, color, length options
• Facial Details: Expression, face shape, asymmetry controls

Portrait Master: Skin Details

Advanced skin rendering controls:

• Skin Quality: Natural skin, bare face, washed/dried effects
• Details: Skin pores, imperfe