base on This node was designed to help AI image creators to generate prompts for human portraits. # 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](https://github.com/ltdrdata/ComfyUI-Manager) - For easy installation - [ComfyUI Prompt Control](https://github.com/asagi4/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`](nodes/base-character) for core features 2. **Chain Additional Nodes** - Connect [`PortraitMasterSkinDetails`](nodes/skin-details), [`PortraitMasterStylePose`](nodes/style-pose), etc. 3. **Configure Parameters** - Adjust sliders and dropdowns to your preferences 4. **Connect to Prompt** - Link the final output to your [`CLIPTextEncode`](nodes/clip-text-encode) 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, imperfections, acne, tanned skin - **Features**: Dimples, freckles, moles, wrinkles - **Eyes**: Detailed eye rendering, iris details, pupil shape #### Portrait Master: Style & Pose Environmental and artistic controls: - **Poses**: 87+ model poses from the pose library - **Clothing**: General clothing and female lingerie options - **Lighting**: 70+ professional lighting setups with direction control - **Styles**: 65+ artistic styles from vintage to modern - **Enhancement**: Photorealism improvement toggle #### Portrait Master: Make-up Comprehensive makeup system: - **Styles**: Various makeup styles and color schemes - **Individual Elements**: Eyeshadow, eyeliner, mascara, blush, lipstick, lip gloss - **Color Control**: Specific makeup color selection #### Portrait Master: Face Generator Simplified face generation for quick results: - **Optimized Settings**: Pre-configured for frontal, symmetrical faces - **Essential Controls**: Gender, age, nationality, basic features - **Clean Output**: Neutral expressions with professional lighting #### Portrait Master: Prompt Styler Converts traditional weighted prompts to conversational style: - **Style Options**: Descriptive, cinematic, illustrative, artistic, documentary, fashion - **Modern Compatibility**: Optimized for Flux, Sana, HiDream, and similar models - **Clean Conversion**: Removes SD1.5/SDXL weight syntax ## 🎛️ Preset System ### Saving Presets 1. Configure all parameters in a node to your desired settings 2. Scroll to the `--- PRESETS ---` section at the bottom 3. Enter a descriptive name in the `save_preset_as` field (e.g., "Cyberpunk Hero") 4. Toggle `save_preset` to `True` 5. Queue the prompt to save the preset 6. Turn `save_preset` back to `False` ### Loading Presets 1. Use the `load_preset` dropdown menu 2. Select from your saved presets for that specific node 3. Queue the prompt to apply the preset settings ### Preset Storage Presets are stored in [`comfyui-portrait-master/presets/`](presets/) with separate subdirectories for each node type: - [`presets/BaseCharacter/`](presets/BaseCharacter/) - [`presets/SkinDetails/`](presets/SkinDetails/) - [`presets/StylePose/`](presets/StylePose/) - [`presets/Makeup/`](presets/Makeup/) - [`presets/FaceGenerator/`](presets/FaceGenerator/) ## 🎲 Random Generation Enable creative exploration with built-in randomization: - **Random Option**: Select "random 🎲" from any dropdown - **Seed Control**: Connect a seed input for reproducible randomization - **Weight Control**: Use sliders to control the influence of random selections ## 📊 Available Parameters ### Core Parameters | Parameter | Description | Options | |-----------|-------------|---------| | [`shot`](lists/shot_list.txt) | Portrait framing type | 8 options (Head portrait, Full body, etc.) | | [`gender`](lists/gender_list.txt) | Character gender | Man, Woman | | [`age`](lists/age_list.txt) | Character age | Multiple age ranges | | [`nationality_1`](lists/nationality_list.txt) & [`nationality_2`](lists/nationality_list.txt) | Ethnicity options | 192 nationalities | | [`body_type`](lists/body_type_list.txt) | Body build | Multiple body types | | [`eyes_color`](lists/eyes_color_list.txt) | Eye color | 10+ color options | | [`hair_style`](lists/hair_style_list.txt) | Hairstyle | 100+ styles | | [`hair_color`](lists/hair_color_list.txt) | Hair color | 21 color options | ### Advanced Controls - **Weight Parameters**: Fine-tune influence with decimal precision (0.00-2.00) - **Nationality Mixing**: Blend ethnicities using `nationality_mix` slider (0.0-1.0) - **Facial Asymmetry**: Add realistic facial variations - **Skin Details**: Control pores, imperfections, and natural skin effects - **Lighting Direction**: Professional lighting setups with directional control ## 🖼️ Model Pose Library The [`model_pose`](lists/model_pose_list.txt) option provides 87+ predefined poses: - Disable ControlNet when using pose library - Adjust framing with the [`shot`](lists/shot_list.txt) parameter - Poses are optimized for portrait generation  ## 💡 Tips & Best Practices ### Optimal Settings - **Skin Details**: High values may override shot settings - reduce if needed - **Eye Details**: Balance with shot type to avoid conflicts - **Negative Prompts**: Add `(closeup, close up, close-up:1.5)` if detail parameters interfere - **Model Selection**: Use high-quality checkpoints for best results ### Recommended Models - **[FormulaXL 2.0](https://civitai.com/models/129922?modelVersionId=160525)** - Excellent for photorealistic portraits - **SDXL Models** - Generally provide superior portrait quality - **Flux Models** - Use with Prompt Styler for optimal results ### Workflow Integration - **Compatible with [Prompt Composer](https://github.com/florestefano1975/comfyui-prompt-composer/)** - **Chain multiple Portrait Master nodes** for complex character creation - **Use presets** to maintain consistency across projects ## 🔧 Troubleshooting ### Common Issues **Node not appearing in ComfyUI** - Ensure ComfyUI is restarted after installation - Check that files are in the correct `custom_nodes` directory - Verify no Python errors in the console **Random options not working** - Connect a seed input to enable randomization - Ensure "random 🎲" is selected in dropdown menus - Check that the seed is properly connected **Preset system not working** - Verify write permissions in the ComfyUI directory - Check that the `presets` folder is created automatically - Ensure preset names don't contain invalid characters **Nationality mixing not working** - Install [ComfyUI Prompt Control](https://github.com/asagi4/comfyui-prompt-control) for full syntax support - Use the format: `[nationality_1:nationality_2:mix_value]` - This feature is experimental and may not work with all models **Output prompts too complex** - Use the Prompt Styler node to simplify for modern models - Reduce weight values for subtle effects - Set unused parameters to "-" to exclude them ### Performance Issues - **Large workflows**: Consider using fewer nodes simultaneously - **Memory usage**: High detail settings may increase VRAM requirements - **Generation speed**: Complex prompts may slow down inference ## 📝 Version History ### Version 3.5.0 (Latest) - ✨ **New**: Face Generator node for simplified face creation - ✨ **Enhanced**: Base Character node with breast and butt size options - 🔧 **Improved**: Overall code performance and stability ### Version 3.4.0 - ✨ **New**: Comprehensive preset system across all nodes - ✨ **New**: Prompt Styler node for modern model compatibility - 🔄 **Restructured**: Split into five specialized modules - 🔧 **Improved**: Code optimization and performance enhancements ### Previous Versions See [CHANGELOG.md](CHANGELOG.md) for complete version history. ## 🤝 Contributing We welcome contributions to improve Portrait Master: - **Bug Reports**: Use GitHub Issues for bug reports - **Feature Requests**: Suggest new features via GitHub Issues - **Code Contributions**: Submit pull requests with improvements - **Documentation**: Help improve documentation and examples ## 📄 License This project is licensed under the terms specified in the [LICENSE](LICENSE) file. ## 💖 Support the Project If you find Portrait Master useful, please consider supporting the developer: **☕ [Support on Ko-fi](https://ko-fi.com/stefanoflore75)** Your support helps maintain and improve this project for the entire community. ## 🔗 Related Projects - **[ComfyUI Prompt Composer](https://github.com/florestefano1975/comfyui-prompt-composer/)** - Advanced prompt composition tools - **[ComfyUI HiDiffusion](https://github.com/florestefano1975/ComfyUI-HiDiffusion/)** - High-resolution diffusion enhancements ## 📚 Additional Resources - **[Legacy Documentation](PORTRAIT_MASTER_2.9.2.md)** - Documentation for Portrait Master 2.9.2 - **[Example Workflows](workflow/)** - Sample workflows for different use cases - **[Developer Website](https://stefanoflore.it)** - More projects and resources --- **Created by [AI Wiz Art](https://ai-wiz.art) (Stefano Flore)** **Version 3.5.0** | **[GitHub Repository](https://github.com/florestefano1975/comfyui-portrait-master)** ", Assign "at most 3 tags" to the expected json: {"id":"6104","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"