ComfyUI Nox Prompter

ComfyUI Nox Prompter

Modular prompt-engineering tools for ComfyUI that turn cinematic ideas into production-ready text blocks, complete with palette controls, safety rails, and workflow guidance.

TL;DR: Drop the folder into ComfyUI/custom_nodes, restart ComfyUI, and look for the NoxPrompter category. Need to verify the install? Run python test_nodes.py from this directory.

Highlights

• 22 purpose-built nodes spanning builders, character design, wardrobe, lighting, camera direction, NSFW safeguards, streaming prompts, analysis, and pipeline organization.
• Formula-driven Wan 2.2 builder with curated motion, composition, and stylization vocabularies plus inline overrides and randomization; pair with Lighting Master for centralized lighting control.
• Preset-friendly companions – every major node supports save/load/list actions so you can build libraries of looks, poses, palettes, and camera moves.
• Consistency tooling – Narrative Weaver, Palette Mixer, Organizer, and Pipeline Combiner keep every fragment aligned, with automatic contradiction warnings.
• Safety-first NSFW workflow – mature prompts include baseline negatives, safety notes, and an NSFW AIO fusion node to merge designer + action outputs responsibly.
• Single-script smoke test – test_nodes.py exercises the entire suite, validating node registration, preset behaviors, and safety defaults before you hit render.

Node Catalog

Onboarding & Organization

• NoxPromptUsageGuide (NoxPrompter/Guides) – Generates quickstart or extended documentation (workflow steps, pairings, safety reminders) directly inside ComfyUI.
• NoxPromptOrganizer (NoxPrompter/Utility) – Collates fragments from multiple nodes into a readable, ordered prompt, highlights missing sections, and produces a checklist.

Core Builder Stack

• NoxPromptBuilder (NoxPrompter/Builders) – Wan 2.2 style prompt assembler with basic/advanced formulas, keyword styling, randomization, preset storage, and pass-through inputs for Lighting Master and Camera Master outputs.
• NoxPromptBlueprintGenerator (NoxPrompter/Builders) – Generates ready-to-use subject, scene, motion, hook, palette override, and insight strings from curated archetype, profession, temperament, environment, lighting, and style tables with custom overrides and presets.
• NoxPromptPaletteMixer (NoxPrompter/Companions) – Produces palette override strings, custom keyword bundles, and usage notes from cinematic mood profiles.
• NoxPromptNarrativeWeaver (NoxPrompter/Companions) – Outputs subject, scene, motion, hook, and descriptor text blocks from archetype + tone selectors.
• NoxPromptCombiner (NoxPrompter/Text) – Blends up to three prompts via concatenate, alternate, blend, or weighted strategies.
• NoxPromptEnhancer (NoxPrompter/Text) – Adds emphasis, quality tags, and style packs (artistic, photorealistic, cinematic, fantasy, sci-fi, portrait) to any prompt.
• NoxPromptAnalyzer (NoxPrompter/Analysis) – Reports word count, complexity, detected style, sentiment, and optional quick critiques for the provided prompt.
• NoxPromptPromptInspector (NoxPrompter/Analysis) – Cleans, deduplicates, and organizes prompt fragments, highlights contradiction warnings, and produces fragment lists and metrics for QA passes.

Character & Styling Suite

• NoxPromptCharacterCreator (NoxPrompter/Characters) – Builds lore-rich hero bios, story hooks, and prompt fragments with presetable archetypes and traits.
• NoxPromptHumanDesigner (NoxPrompter/Characters) – Adult anatomy guardrails plus detailed face, body, skin, eye, and pose descriptors with consent messaging.
• NoxPromptWardrobeDesigner (NoxPrompter/Characters) – Describes garments, materials, accessories, motion considerations, and styling notes for any wardrobe concept.

Cinematic Direction

• NoxPromptActionDirector (NoxPrompter/Direction) – Crafts kinetic action prompts, summaries, and director notes with camera, tempo, props, and risk guidance.
• NoxPromptCameraMaster (NoxPrompter/Direction) – Aggregates shot size, lensing, motion, rigging, palette, and safety notes into a single camera prompt stream for Builder and Organizer nodes (alias: NoxPromptCameraLanguage for legacy graphs).
• NoxPromptLightingMaster (NoxPrompter/Direction) – Consolidates all lighting source, quality, and time-of-day palettes into one node and outputs lighting setups, mood notes, and technical rigging reminders for complex scenes.
• NoxPromptCamz (NoxPrompter/Direction) – Streaming-focused prompt generator with persona, stage, overlay, and safety mentions for creator economy workflows.

Posing & Staging

• NoxPromptPoseMaster (NoxPrompter/Posing) – Directs all-ages pose direction with camera, lighting, set, and energy guidance plus baseline negatives and coaching reminders.

NSFW Toolkit (Adults Only)

• NoxPromptNSFWDesigner (NoxPrompter/NSFW) – Safely assembles sensual prompts with wardrobe, pose, lighting, and explicitness controls plus baseline negatives.
• NoxPromptNSFWPoseMaster (NoxPrompter/NSFW) – Directs adult-only posing with camera, lighting, and heat controls while surfacing safety briefs and negative guidance.
• NoxPromptNSFWActionDirector (NoxPrompter/NSFW) – Produces choreography-focused NSFW action prompts, summaries, and consent-oriented safety notes.
• NoxPromptNSFWAIO (NoxPrompter/NSFW) – Fuses designer + action outputs into a single prompt/negative/safety stack while deduplicating keywords and warnings.

Pipeline Assembly

• NoxPromptPipelineCombiner (NoxPrompter/Pipeline) – Weaves every module’s outputs into a production-ready master prompt, negative list, step order, and reference notes with contradiction detection.

Installation

| Method | Steps | | --- | --- | | ComfyUI Manager | Search for “Nox Prompter”, click Install, restart ComfyUI. | | Git clone (recommended) | cd /path/to/ComfyUI/custom_nodes → git clone https://github.com/jamesk9526/ComfyNoxPrompter.git → restart ComfyUI. | | Manual download | Download ZIP → extract to ComfyUI/custom_nodes/ComfyNoxPrompter/ → restart ComfyUI. |

After the restart, right-click the canvas and confirm a NoxPrompter category with the nodes listed above. If something is missing, see the Troubleshooting section.

Quickstart Workflow

1. Ask the Usage Guide – Drop NoxPromptUsageGuide, set detail_level = Extended, and review the generated workflow and safety pointers in ComfyUI.
2. Define your hero – Chain NoxPromptCharacterCreator → NoxPromptHumanDesigner → NoxPromptWardrobeDesigner to lock identity, anatomy, and wardrobe language.
3. Seed the narrative – Run NoxPromptBlueprintGenerator for a quick subject/scene/motion/emotion blueprint, refine with NoxPromptNarrativeWeaver, and capture palette overrides + keywords via NoxPromptPaletteMixer.
4. Assemble the master prompt – Feed the outputs into NoxPromptBuilder (Advanced Formula) and optionally enable randomize_missing with a seed for repeatable variations.
5. Polish or enhance – Run the builder result through NoxPromptEnhancer or NoxPromptCombiner to layer styles, emphasis, or alternate prompts.
6. Add direction – NoxPromptActionDirector and/or NoxPromptLightingMaster create dedicated camera + lighting clauses; NoxPromptCamz covers streaming personas.
7. Safety-check NSFW work – For mature scenes, route through NoxPromptNSFWDesigner and optionally NoxPromptNSFWActionDirector, then merge with NoxPromptNSFWAIO.
8. Finalize and organize – Use NoxPromptPipelineCombiner to merge every fragment into a single prompt package, then optionally tidy with NoxPromptOrganizer before sending to your sampler.

Detailed Usage

Builder & Companion Trio

• Blueprint Generator – Start with NoxPromptBlueprintGenerator to rapidly draft subject, scene, motion, emotion, and palette overrides from curated dropdowns. Its outputs slot directly into the Builder (subject/scene/motion), Palette Mixer (overrides), or Organizer (insight notes) when you need an ideation-safe baseline.
• Narrative Weaver → Palette Mixer → Prompt Builder gives you richly described subject/scene/motion text plus cinematic palette overrides in seconds.
• Set keyword_style to auto for labeled clauses, inline for free-flow descriptions, or compact for dense Wan 2.2 strings.
• Turn on randomize_missing when dropdowns are left at “None”; the combination of curated vocabularies and seeded randomness is great for ideation batches.

Character & Wardrobe Stack

• The character trio outputs three synchronized strings: a hero prompt, a formatted sheet, and story hooks. Feed the prompt into the Builder, keep the sheet for production notes, and park the hooks in your project management tool.
• NoxPromptHumanDesigner automatically appends adult-consent language and negative prompts. You can substitute your own copy via consent_language and safety_addendum fields.
• Wardrobe Designer exports the hero look, a bullet list of styling notes, and an accessories-only string. Route the prompt into the Builder or Combiner and hand the accessory list to your prop artist.

Directional Nodes

• NoxPromptPoseMaster handles all-ages pose staging. It combines pose profiles, camera framing, lighting, set design, and energy cues, then outputs prompt/negative/brief/guidance strings with coaching and comfort reminders.
• NoxPromptActionDirector and NoxPromptNSFWActionDirector share a schema: defaults cover preset combos, while every control offers a “Custom Input” field when you need bespoke language.
• Lighting Master produces three parallel outputs (prompt, mood notes, technical notes). Feed the prompt to the Builder or Pipeline Combiner, and keep the technical notes for your lighting checklist.
• NoxPromptCamz focuses on creator economy scenarios (persona, stage theme, overlays). Disable include_negative_baseline if downstream automation already injects safety negatives.

NSFW Flow (Adults Only)

• Keep include_negative_baseline and include_safety_note enabled unless you have verified policy tooling downstream. They block underage terms, coercion, non-consensual language, and extreme anatomy references by default.
• NoxPromptNSFWPoseMaster focuses on staging: it merges pose profiles with camera framing, lighting, heat, and explicitness controls, then outputs a dedicated prompt/negative/brief trio plus safety notes. Use it to lock pose direction before layering wardrobe or action cues.
• NoxPromptNSFWActionDirector adds choreography and consent beats. Hand its action_prompt to the Builder or Combiner, and archive the safety_notes for compliance logs.
• NoxPromptNSFWAIO merges designer + director outputs, deduplicates negatives, and ensures safety notes stay intact. It also accepts extra positives/negatives if you have studio-specific rules.

Pipeline Assembly & Organization

• NoxPromptPipelineCombiner stitches builder output, character data, wardrobe pieces, narrative text, action notes, lighting cues, NSFW notes, and custom strings into a single master prompt. It also produces:
  • Aggregated negative list (merging builder, enhancer, NSFW baselines, etc.).
  • Pipeline order referencing every node used (matches the Usage Guide’s recommendations).
  • Reference notes grouped by theme (camera, motion, palette, safety) with contradiction warnings when descriptors disagree.
• NoxPromptOrganizer is perfect for presentation. Select a structure mode (Builder-first, Narrative-first, Lighting-first), and it will output a formatted prompt, a missing-section list, and a quick overview for review sessions.
• NoxPromptPromptInspector runs a QA pass on any prompt or negative block—splitting fragments, deduplicating them, running contradiction detection, and emitting organized fragments plus metrics you can feed into review docs or the Organizer.

Preset Manager (Shared Behavior)

• Most nodes expose preset_action (none, save, load, list) and preset_name. These hook into the shared PresetManager to store JSON presets under ComfyNoxPrompter/presets/<node_name>/.
• Typical flow:
  1. Configure the node, set preset_action = save, choose a preset_name, and execute once.
  2. Switch to preset_action = load (or list) to recall the configuration on future runs.
• Presets are simple text files—commit them alongside your project or share them with teammates.

Verification & Tests

Run the bundled regression script any time you update the repository or tweak presets:

cd C:\Users\James\Documents\GitHub\ComfyNoxPrompter
python test_nodes.py

The script validates node registration, prompt outputs, preset save/load flows, safety baselines, and the pipeline sequence. All tests should pass before shipping to production pipelines.

File Structure

ComfyNoxPrompter/
├── __init__.py                # ComfyUI entry point
├── NoxPromptNode.py           # Legacy aggregator with resilient imports
├── INSTALLATION.md            # Install cheat sheet
├── README.md                  # You are here
├── test_nodes.py              # Offline regression tests
├── examples/README.md         # Sample workflows and diagrams
├── noxprompter/               # Modular package (common utilities, constants, node modules)
└── LICENSE

Troubleshooting

• Nodes missing after restart – Make sure the folder name is exactly ComfyNoxPrompter. Restart ComfyUI completely after copying or updating.
• ModuleNotFoundError: noxprompter – The aggregator now injects its path automatically, but if you renamed folders, ensure NoxPromptNode.py sits beside the noxprompter/ package.
• Preset files not saving – Verify the process has write access to ComfyNoxPrompter/presets. Presets are stored per node (e.g., presets/prompt_builder/<name>.json).
• Negative prompts missing safety terms – Double-check the NSFW nodes’ baseline toggles and avoid trimming the negative string downstream.
• Need examples – See examples/README.md for wiring diagrams and step-by-step walkthroughs.

Contributing & Support

• Open issues or feature ideas on the GitHub tracker.
• Run python test_nodes.py before submitting a pull request so maintainers can reproduce your results quickly.
• For private questions or collaboration, feel free to open a discussion thread in the repository.

License

Released under the MIT License. See LICENSE for full terms.

---

Happy prompting! Build cinematic stories, stay consistent, and keep every node in sync.