<h1 id="minimax-h3-prompt-writer-for-comfyui">MiniMax H3 Prompt Writer for ComfyUI</h1>MiniMax H3 Prompt Writer is a ComfyUI extension for writing prompts specifically for MiniMax H3.Describe what you want in normal language, add image / video / audio references, and let a local or API model turn it into an editable H3 prompt.<h3 id="what's-new-in-v0.4.0">What's new in v0.4.0</h3><ul><li>Qwen 3.8 support for Direct GGUF, with vision and optional Thinking.</li><li>Support for compatible Qwen 3.8 fine-tunes and Qwen3-VL models.</li><li>Replace Reference assets without changing their position.</li><li>Improved context handling and Direct GGUF stability.</li></ul>GitHub: <a target="_blank" rel="ugc" href="https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer">https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer</a><hr /><h2 id="features">Features</h2>Supports all current H3 input modes:<ul><li>T2VA</li><li>I2VA</li><li>FL2VA</li><li>L2VA</li><li>Reference</li></ul>Reference mode supports up to 9 images, 3 videos and 3 audio references, with 12 files total. <img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/cd35f5b8-f6e4-4321-b220-e9b372e79b66/original=true/cd35f5b8-f6e4-4321-b220-e9b372e79b66.jpeg" />You can tell Writer exactly what each reference should provide:<blockquote>Use Picture 1 for the character, Picture 2 only for the clothes, and only the movement from Video 1. Put the character on a rainy street at night.</blockquote>Writer handles the H3-specific prompt structure and reference syntax around that.Other features:<ul><li>Editable generated prompts</li><li>Refine an existing prompt with a short instruction</li><li>Separate saved drafts for every H3 mode</li><li>Insert Picture / Video / Audio tags directly into the text</li><li>Video contact sheets with frame sampling controls</li><li>Automatic context handling</li><li>Local model unload and VRAM controls</li><li>Custom system prompts</li><li>Official MiniMax prompt-writing guides used during generation</li><li>MiniMax Music 3 workspace</li></ul>This is a UI extension, not a workflow node.It does not run MiniMax H3, modify your graph or queue a video. It writes the prompt, then you copy it into your existing H3 workflow.<hr /><h2 id="prompt-model-providers">Prompt Model Providers <img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/fbbd6bbd-6ae3-4750-b5c1-975fab4a0400/original=true/fbbd6bbd-6ae3-4750-b5c1-975fab4a0400.jpeg" /> </h2>The model writing the prompt is separate from the MiniMax H3 model used in your video workflow.There are currently four ways to run it.<h3 id="ollama">Ollama</h3>Probably the easiest local option for most people.Gemma 4 is the recommended local model family. Qwen 3.6 was also tested through Ollama in all five H3 modes without requiring Qwen-specific changes.<h3 id="direct-gguf">Direct GGUF</h3>Loads the prompt model directly inside ComfyUI through <code>llama-cpp-python</code>.Direct GGUF is currently built and validated around Gemma 4 with its matching vision projector.<h3 id="external-llama.cpp">External llama.cpp</h3>Connect Writer to your own <code>llama-server</code>.Useful if you already use llama.cpp or want full control over model loading, GPU placement, context, KV cache and the runtime itself.<h3 id="api-providers">API Providers</h3>Supports:<ul><li>Gemini</li><li>OpenAI</li><li>OpenRouter</li><li>Custom OpenAI-compatible endpoints</li></ul>Custom endpoints can also be used with local servers such as LM Studio.Local providers keep the prepared media and prompt request on your machine.Remote API providers receive the data required for the prompt request.Provider guide: <a target="_blank" rel="ugc" href="https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/PROVIDERS.md">https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/PROVIDERS.md</a><hr /><h2 id="minimax-music-3">MiniMax Music 3</h2>Prompt Writer also includes a separate workspace for MiniMax Music 3.Describe the track you want in normal language and Writer builds the structured Music 3 caption.Lyrics can be written manually, generated from the Music Brief, or rewritten using Refine.Music 3 is separate from H3 video prompting, but uses the same provider system.<hr /><h2 id="basic-usage">Basic Usage</h2><ol><li>Open H3 Prompt Writer</li><li>Go to Settings and choose your provider / model</li><li>Select the H3 mode</li><li>Add your references</li><li>Write the Creative Brief normally</li><li>Press Generate prompt</li><li>Edit it, use Refine, or copy it into your H3 workflow <img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/6334ef34-26c4-4517-9620-369526550d7f/original=true/6334ef34-26c4-4517-9620-369526550d7f.jpeg" /> </li></ol>You do not need to manually write H3 timestamps, sections or reference formatting.<hr /><h2 id="installation">Installation</h2>Download the ZIP from this Civitai page.Extract:<pre><code>ComfyUI-MiniMaxH3-Prompt-Writer</code></pre>into:<pre><code>ComfyUI/custom_nodes/</code></pre>The final path should look like:<pre><code>ComfyUI/custom_nodes/ComfyUI-MiniMaxH3-Prompt-Writer/</code></pre>Then restart ComfyUI.You can also install the latest version directly from GitHub:<pre><code>cd ComfyUI/custom_nodes
git clone https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer.git</code></pre>Open it using the floating H3 Prompt Writer button <img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/d3056d8a-efab-41fd-91bc-e9170649f6be/original=true/d3056d8a-efab-41fd-91bc-e9170649f6be.jpeg" /> or:Extensions &gt; H3 Prompt WriterImportant: This is a UI extension. No H3 Prompt Writer node will appear in node search.Full installation guide: <a target="_blank" rel="ugc" href="https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/INSTALLATION.md">https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/INSTALLATION.md</a><hr /><h2 id="direct-gguf-setup">Direct GGUF Setup</h2>If you want to use Direct GGUF on Windows Portable with NVIDIA, open PowerShell or CMD in the ComfyUI Portable folder and run:<pre><code>.\python_embeded\python.exe -m pip install --only-binary=:all: --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cu130 "llama-cpp-python&gt;=0.3.35,&lt;0.4"</code></pre>Then restart ComfyUI.H3 Prompt Writer &gt; Settings &gt; Direct GGUFUse Browse verified models to choose a supported GGUF + matching <code>mmproj</code>.Place both files under:<pre><code>ComfyUI/models/LLM/</code></pre>For most users, Ollama is still the simpler recommended local setup.Full Direct GGUF guide: <a target="_blank" rel="ugc" href="https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/DIRECT_GGUF.md">https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/DIRECT_GGUF.md</a><hr /><h2 id="notes">Notes</h2><ul><li>Video references are shown to the prompt model as ordered contact sheets instead of the full encoded video.</li><li>Prompt models do not listen to uploaded audio files. Describe what should be taken from the audio, such as voice, music, rhythm or soundtrack.</li><li>The base extension has no additional Python requirements.</li><li>Remote API providers receive the data needed for the request. Local providers keep it local.</li><li>The project itself is released under the MIT License.</li><li>MiniMax-provided guides and model files retain their upstream terms.</li></ul><hr /><h2 id="links">Links</h2>GitHub <a target="_blank" rel="ugc" href="https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer">https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer</a>Usage / Creative Brief examples <a target="_blank" rel="ugc" href="https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/USAGE.md">https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/USAGE.md</a>Provider guide <a target="_blank" rel="ugc" href="https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/PROVIDERS.md">https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/PROVIDERS.md</a>Troubleshooting <a target="_blank" rel="ugc" href="https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/TROUBLESHOOTING.md">https://github.com/duckyshell/ComfyUI-MiniMaxH3-Prompt-Writer/blob/main/docs/TROUBLESHOOTING.md</a><hr />

MiniMax H3 Prompt Writer

Added Qwen 3.8 and Qwen3-VL support, improved Direct GGUF compatibility, and added in-place Reference asset replacement.

Files with SHA256: 71fa7a33cadac26b01ed47404df66fa340a60662e1b3bc529e2dbe83fad466a6