ComfyUI Nox Prompter

Download --> jamesk9526/NoxPrompter-ComfyUI-CustomNode

A powerful collection of custom nodes for ComfyUI that enhance prompt handling, manipulation, and analysis for better AI image generation results.

🌟 Features

• Formula-driven Prompt Builder: Assemble cinematic Wan 2.2 prompts with guided subject, scene, motion, aesthetic, and style controls

• Palette + Narrative Companions: Use the Palette Mixer and Narrative Weaver to seed builder inputs with curated palettes and story scaffolding

• Prompt Enhancement: Automatically enhance prompts with style-specific additions and quality tags

• Prompt Combination: Combine multiple prompts using various blending modes

• Prompt Analysis: Analyze prompt characteristics, complexity, and style detection

• Emphasis Control: Apply emphasis and de-emphasis to prompts using weights

• Curated Keyword Palettes: Built-in lighting, camera, motion, emotion, and stylization vocabularies for rapid iteration

• Adaptive Keyword Controls: Switch between auto, inline, or compact keyword formatting, randomize missing selections with seeds, and override palettes inline

• NSFW Prompt Designer: Assemble mature-oriented prompts with curated safeguards, automatic baselines, and safety guidance

📦 Installation

Method 1: Git Clone (Recommended)

1. Download From jamesk9526/NoxPrompter-ComfyUI-CustomNode

2. unzip the file.

3. move to the comfy Ui folder custom nodes.

🎯 Node Overview

1. Nox Prompt Builder

Category: NoxPrompter/Builders

Build cinematic Wan 2.2 prompts by mixing formulas with curated lighting, camera, motion, emotion, and stylization vocabularies.

Guiding formulas

• Basic Formula — Subject + Scene + Motion for fast ideation.

• Advanced Formula — Subject (desc) + Scene (desc) + Motion (desc) + Aesthetic controls + Stylization for production-ready prompts.

Core inputs

• formula (DROPDOWN): Choose Basic or Advanced structure

• subject_focus, scene_setting, motion_arc (STRING): Rich natural-language descriptions

• narrative_hook, model_emphasis (STRING, Optional): Extra beats or feature emphasis

• keyword_style (auto, inline, compact): Control how curated keywords appear in the assembled prompt

• randomize_missing + random_seed: Auto-fill "None" selections with curated palette picks

• palette_overrides: Inline overrides (e.g. light_source: Moonlight, Firelight) that merge with dropdown selections

• extra_descriptors, custom_keywords, prompt_prefix, prompt_suffix (STRING, Optional)

• negative_prompt (STRING, Optional): Direct output channel for Wan 2.2 negatives

Keyword palettes

• Aesthetic controls: Light Source, Light Quality, Time of Day, Shot Size, Composition, Lens Focal Length, Lens Angle, Lens Shot Type, Color Tone

• Dynamics: Motion Type (running, skateboarding, soccer, tennis, ping pong, skiing, basketball, football, bowl dance, cartwheel), Emotion (anger, fear, joy, sadness, surprise), Camera Moves (push-in, pull-out, pan left/right, tilt up, handheld, compound, following, orbit)

• Stylization: Visual Styles (felt style, 3D cartoon, pixel art, puppet animation, 3D game, claymation, anime, watercolor, B&W animation, oil painting) and Special Effects (tilt-shift, time-lapse)

• Overrides & extras: Merge additional palette lines (lens_angle: Low Angle | Tilted Angle) and append bespoke keyword clusters without losing dropdown state

Outputs

• prompt: Fully assembled prompt following the selected formula

• negative_prompt: Pass-through of the user-provided negative list

• aesthetic_notes: Summaries of the chosen lighting, camera, and color selections

• dynamic_notes: Summaries of motion, emotion, and camera move selections

Example (Advanced Formula)

Prefix: "Wan 2.2 cinematic prompt"
Subject: "Battle-hardened warrior drenched in rain, leather armor and fur"
Scene: "Muddy battlefield at night, lightning on the horizon"
Motion: "Charges forward roaring, blade swings in slow-motion crash zoom"
Aesthetic Picks: Daylight · Soft Light · Dusk · Medium Close-up · Balanced · Medium focal · Low angle · Single shot · Warm tone
Dynamics: Running · Anger · Push-in · Orbit
Stylization: Anime · Tilt-shift
Custom Keywords: "heroic energy, epic storytelling"

Result → A multi-sentence prompt with labeled cinematic palette, motion & camera clause, stylization clause, keyword styling control, and appended custom keywords — ready to paste into Wan 2.2.

### 2. Nox Prompt Palette Mixer
**Category**: `NoxPrompter/Companions`

Curate palette overrides and keyword clusters without touching spreadsheets. Pick a cinematic mood, dial intensity, and optionally add your own override lines — the mixer outputs ready-to-paste builder overrides and matching keyword suggestions.

**Inputs**
- `mood_profile`: Curated looks (Moody Nightfall, Action Spotlight, Dreamscape Glow)
- `intensity`: Blends in advanced overrides and keywords when pushed above 0.6
- `include_effects`: Toggle built-in special effects additions
- `custom_palette`: Extra override lines or keywords that merge with the result

**Outputs**
- `palette_overrides`: Multi-line text (e.g. `light_source: Moonlight, Practical Light`)
- `custom_keywords`: Comma-separated keywords to feed into the builder
- `notes`: Helpful summary of the chosen profile, intensity, and effects

### 3. Nox Prompt Narrative Weaver
**Category**: `NoxPrompter/Companions`

Generate narrative scaffolding — subject focus, scene setting, motion arc, narrative hook, and extra descriptors — from cinematic archetypes, tones, environments, set pieces, and tempo profiles.

**Inputs**
- `hero_archetype`: e.g. Resolute Protector, Wandering Visionary, Arcane Duelist
- `story_tone`: e.g. Hopeful Resurgence, Brooding Tension, Whimsical Discovery
- `environment`: e.g. Rain-Soaked Citadel, Skybound Orchard, Desert Mirage Bazaar
- `set_piece`: Action beats such as Climactic Duel, Heist Dash, Revelation Stillness
- `tempo`: Motion cadence presets (slow burn, measured build, surging, frantic)
- `focus_detail`: Extra keywords folded into the descriptor stack

**Outputs**
- `subject_focus`, `scene_setting`, `motion_arc`, `narrative_hook`, `extra_descriptors` — each aligns directly with builder inputs

4. Nox Prompt Enhancer

Category: NoxPrompter/Text

Enhances your base prompt with style-specific additions, quality tags, and emphasis control.

Inputs:

• base_prompt (STRING): Your main prompt text

• enhancement_mode (DROPDOWN): Choose from artistic, photorealistic, cinematic, fantasy, sci-fi, portrait, or none

• emphasis_strength (FLOAT 0.0-2.0): Control emphasis level using parentheses syntax

• add_quality_tags (BOOLEAN): Automatically add quality enhancement tags

• secondary_prompt (STRING, Optional): Additional prompt to combine

• negative_prompt (STRING, Optional): Negative prompt input

• custom_style (STRING, Optional): Your own custom style additions

Outputs:

• enhanced_prompt (STRING): The enhanced version of your prompt

• negative_prompt (STRING): Processed negative prompt

Example Usage:

Input: "a cat sitting on a chair"
Enhancement Mode: "photorealistic"
Emphasis Strength: 1.3
Add Quality Tags: True

Output: "((a cat sitting on a chair)), photorealistic, highly detailed, sharp focus, professional photography, high quality, detailed, masterpiece, 8k uhd, dslr, soft lighting, high quality"

5. Nox Prompt Combiner

Category: NoxPrompter/Text

Combines multiple prompts using different blending strategies.

Inputs:

• prompt_1 (STRING): First prompt

• prompt_2 (STRING): Second prompt

• combination_mode (DROPDOWN): concatenate, blend, alternate, or weighted

• weight_1 (FLOAT 0.0-2.0): Weight for first prompt (in weighted mode)

• weight_2 (FLOAT 0.0-2.0): Weight for second prompt (in weighted mode)

• prompt_3 (STRING, Optional): Third prompt

• separator (STRING, Optional): Custom separator (default: ", ")

Outputs:

• combined_prompt (STRING): The combined result

Combination Modes:

• Concatenate: Simple joining with separator

• Blend: Interleave words from different prompts

• Alternate: Alternate sentences between prompts

• Weighted: Apply emphasis/de-emphasis based on weights

6. Nox Prompt Analyzer

Category: NoxPrompter/Analysis

Analyzes prompt characteristics and provides detailed feedback.

Inputs:

• prompt (STRING): Prompt to analyze

• analysis_type (DROPDOWN): word_count, complexity, style_detection, or full_analysis

Outputs:

• analysis_result (STRING): Detailed analysis text

• word_count (INT): Number of words in the prompt

• complexity_score (FLOAT): Complexity rating (0-10)

Analysis Features:

• Word count and length categorization

• Complexity scoring based on vocabulary and uniqueness

• Style detection (photorealistic, artistic, anime, cinematic, etc.)

• Sentiment analysis (positive, negative, neutral)

7. Nox Prompt NSFW Designer

Category: NoxPrompter/NSFW

Crafts mature-oriented prompts with curated tone, wardrobe, and safety guards. The node blends tasteful descriptors with required baselines so you can focus on creative direction while staying compliant.

Inputs

• subject_focus, scene_setting (STRING): Core concept and environment

• pose_profile, wardrobe_style, tone_profile (DROPDOWN): Curated NSFW personas and moods

• lighting_setup, camera_framing, explicitness_level (DROPDOWN, Optional): Fine-tune lighting, lensing, and intensity while auto-managing negatives

• detail_accent, nsfw_tags (STRING, Optional): Extra descriptors and keyword clusters

• negative_prompt (STRING, Optional): Merge your own negatives with the safeguarded baseline

• include_negative_baseline, include_safety_note (BOOLEAN): Toggle the automatic guardrails

Outputs

• prompt: Fully assembled NSFW-ready prompt with pose, wardrobe, lighting, and framing

• negative_prompt: Combined baseline+user list that filters underage, violent, or explicit anatomical extremes

• safety_notes: Quick reminders sourced from the chosen profiles plus a compliance headline

Safety Features

• Baseline negatives covering underage, coercive, or graphic subject matter

• Explicitness-level aware negatives to keep anatomy references tasteful

• Contextual notes explaining how to keep the scene respectful and compliant

🎨 Style Presets

Enhancement Modes Available:

• Artistic: Adds painterly, expressive elements

• Photorealistic: Focuses on realistic photography terms

• Cinematic: Movie and film-style enhancements

• Fantasy: Magical and mystical elements

• Sci-Fi: Futuristic and technological terms

• Portrait: Professional portrait photography focus

💡 Usage Tips

1. Pick the formula first: Choose Basic for brainstorming or Advanced for full cinematic structure

2. Seed with companions: Use the Narrative Weaver and Palette Mixer to generate builder-ready inputs in seconds

3. Tune keyword style: Swap between auto, inline, or compact keyword presentation depending on downstream needs

4. Randomize wisely: Enable randomize_missing with a fixed seed to explore alternates while staying reproducible

5. Layer keyword palettes: Mix lighting, camera, motion, emotion, and style options to rapidly explore looks

6. Layered Enhancement: Feed the builder output into the Prompt Enhancer for stylistic polish

7. Analysis Feedback: Use the Analyzer to understand your prompt characteristics before enhancement

8. Weight Control: In the Combiner, weights > 1.0 add emphasis while < 1.0 reduce it

9. Negative Prompts: Both the Builder and Enhancer accept negative prompts so you can enforce consistency

10. Custom Styles: Use custom_keywords, extra_descriptors, or the Enhancer custom_style input to inject project-specific flavor

11. Guard NSFW work: Route mature concepts through the NSFW Designer to leverage curated baselines, safety notes, and explicitness controls before sharing outputs

🔧 Technical Details

File Structure:

ComfyNoxPrompter/
├── __init__.py                 # Node registration
├── NoxPromptNode.py           # Main node implementations (builder, NSFW designer, palette mixer, narrative weaver, enhancer, combiner, analyzer)
├── README.md                  # This documentation
├── INSTALLATION.md            # Quick install reference
├── test_nodes.py              # Offline sanity tests for each node
├── examples/                  # Example workflows
└── LICENSE                    # License file

Dependencies:

• ComfyUI (obviously!)

• Python 3.7+

• No additional packages required - uses only Python standard library

🤝 Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• ComfyUI community for the excellent framework

• Inspired by the guide from traugdor90 on creating custom nodes

• All the prompt engineering enthusiasts who make AI art better

📞 Support

If you encounter any issues or have questions:

1. Check the Issues page

2. Create a new issue with detailed information about your problem

3. Include your ComfyUI version and any error messages

Happy Prompting! 🎨✨