ComfyUI-StudioPromptDirector

🎬 ComfyUI-StudioPromptDirector

🏛️ Encyclopedic Studio Prompt & Storyboard Director Suite for ComfyUI

ComfyUI-StudioPromptDirector is a studio-grade suite of 6 production nodes engineered for Black Forest Labs (BFL) FLUX.2 / Klein 9B, HiDream-O1 4MP, LTX-Video 2.5, Voice Design / TTS (Qwen3-TTS, ChatterBox, HiggsAudio v3), Multi-Reference Storyboards (Calliope Standard), and Studio Resolution & Aspect Management.

It eliminates manual prompt guesswork by providing over 500+ curated cinematic presets alongside dedicated, labeled custom input fields, aspect ratio controls, and VAE-safe latent generation.

---

🌟 Included Nodes

1. 📐 Studio Resolution & Aspect Master (Resolution, Latent & Safe Snap)

• Calibrated Aspect Ratio Presets: 1:1 Square (1024x1024), 16:9 Cinema Landscape (1344x768), 9:16 Social Story (768x1344), 4:5 Instagram (896x1120), 3:2 DSLR (1152x768), 2.39:1 Anamorphic Scope (1536x640), 21:9 Ultra-Wide (1792x768), 32:9 Panoramic (2048x576), 720p/1080p Video, and HiDream-O1 4MP Native Presets (2560x1440, 2048x2048, 2304x1728, 3104x1312).
• 1-Click Orientation Swap: Instantly toggles between Landscape and Portrait.
• Divisibility Snap Guard: Snaps dimensions to multiples of 16, 32, 64, or 8 to eliminate VAE shape mismatch errors.
• Multi-Architecture Latent Generator: Generates 16-channel FLUX latents, 4-channel Standard (SD/SDXL/Wan/Krea/LTX) latents, or 3-channel HiDream-O1 pixel-space tensors directly.
• Outputs: width, height, empty_latent, aspect_ratio, megapixels, target_upscale_w, target_upscale_h, and info_text.

---

2. 🎨 Flux 2 / Klein Prompt Builder (Official BFL 8-Layer Encyclopedic)

Implements the exact 8-slot structural formula mandated by Black Forest Labs: [SUBJECT], [LOCATION], [STYLE], [CAMERA SETTINGS], [LIGHTING], [COLORS], [EFFECT], [ADDITIONAL ELEMENTS]

• 40+ Art Styles & Mediums: 3D Pixar, Unreal Engine 5, Octane Render, Claymation, 35mm Portra 400, 70mm IMAX, 16mm Bolex, Arri Alexa Mini LF, Vogue Studio, Ghibli, 1980s Retro Anime, Impasto Oil, Renaissance Chiaroscuro, etc.
• 25+ Ethnicities & Origins: Egyptian, Ancient Pharaonic, Mediterranean, Amazigh/Berber, East Asian, South Asian, West/East/South African, Nordic, Celtic, Slavic, Latin American, Sci-Fi Android, etc.
• 12 Age Groups & 15 Body Silhouettes: From infant to centenarian; slim, athletic, hourglass, heroic, plus-size, and transhuman.
• 20 Micro-Expressions & 20 Hairstyles: Psychological micro-expressions and high-detail hair textures/colors.
• 18 Camera Framings & 12 Optics: Extreme close-up to 360-turnaround; Canon 85mm f/1.2, Zeiss 50mm f/1.4, Leica 35mm f/1.4, Panavision Anamorphic 2.39:1, Cooke S4/i.
• 15 Lighting Setups & 12 Color Palettes: Rembrandt chiaroscuro, golden hour, beauty softbox, cyberpunk dual-tone, neon, volumetric god rays.
• 12 Visual Effects & 12 Micro-Physics Details: 35mm film grain, atmospheric dust motes, bloom, motion blur, wind-blown hair, rising steam, rain on glass.
• Dedicated Negative Prompt Presets: Standard Photo Guard, Master Anatomy & Anti-Deformation Guard, 3D CGI Clean, Photoreal Preserver, Anime Cel Guard, and Cinematic Clean.
• 11 Labeled Custom Input Fields: Direct custom override boxes for every single slot.

---

3. 🎥 LTX-Video 2.5 Video Prompt Builder (Official Encyclopedic LTX)

• 6 Cinematic Sequence Modes: Single Continuous Take, Multi-Shot Scene (2-4 Cuts Joined by Hard Cuts), Dub-It IC-LoRA (Speech Replacement), Video-to-Video Edit IC-LoRA, Time-Lapse, and Slow-Motion 1000 FPS.
• 20 Camera Movements & 20 Actor Choreography Presets: Dolly in/out, tracking, 360 arc orbit, handheld, jib boom, rack focus, whip pan, SnorriCam rig, climax slap and recoil, table slam, accusing finger point, etc.
• Multi-Shot Transition Cut Syntax: A hard cut transitions to, A match cut connects the physical action to, The camera whip-pans across to reveal, A sudden smash cut jumps to.
• Synchronized Audio & SFX: Quoted dialogue <d>[English] "..."</d> and bracketed SFX tags [sharp_slap_sfx], [gasp], [cafe_ambience].

---

4. 🎙️ Voice Design & Emotion Prompt Builder (Encyclopedic Qwen3/ChatterBox/Higgs)

• 5 Target Engines: Qwen3-TTS, ChatterBox, HiggsAudio v3, MOSS SoundEffect v2, and Universal TTS Suite.
• 10 Age Brackets & 18 Regional Accents: American standard, British RP, Cockney, Scottish, Irish, Egyptian Arabic melodic English, French lilting, Italian, Spanish, German, Russian, etc.
• 15 Emotional Deliveries & 12 Paralinguistic Injectors: [shouting], [gasps], [laughs], [crying], [sighs], [whisper], [groans], [clears throat], [snicker], [pant].
• Automatic Prosody Rules: Comma , = 0.2s pause, Period . = 0.5s pause, Double dash -- = 0.8s dramatic hesitation, CAPITAL WORDS = volume/stress boost.

---

5. 🧩 Multi-Ref Storyboard Prompt Composer (Encyclopedic BFL / Calliope)

• Covers all 6 official BFL Multi-Ref cases: Scene Compositing (5-Ref), Costume Composite (4-Ref), Place Composite (3-Ref), Style Transfer (2-Ref), Object Replacement (2-Ref), and Single-to-Sheet 360 Turnaround (1-Ref).

---

6. 🏛️ Universal Studio Prompt Director (Master Encyclopedic Hub)

• Central master production hub combining Character 1 casting, Character 2 casting, Multi-Ref storyboard prompt, LTX-Video prompt with dialogue/SFX, and Negative Prompt into a single synchronized node.

---

📥 Installation

Method 1: Via ComfyUI Manager (Recommended)

1. Open ComfyUI Manager.
2. Search for ComfyUI-StudioPromptDirector.
3. Click Install and restart ComfyUI.

Method 2: Manual Git Clone

cd ComfyUI/custom_nodes
git clone https://github.com/nexusfinancial-dev/ComfyUI-StudioPromptDirector.git

Restart ComfyUI and the nodes will be available under the StudioPromptDirector category.

---

📜 License

This project is open-source and licensed under the MIT License. Created with ❤️ by nexusfinancial-dev.