๐ง VRGDG Qwen 2.5 ๐ง
A local Qwen LLM that writes your scene prompts
- image1
- image2
- image3
- image4
- image5
- image6
- image7
- image8
- image9
- image10
- image11
- image12
- image13
- image14
- image15
- image16
- image17
- image18
- image19
- image20
- image21
- image22
- image23
- image24
- text
- used_model
- status
This is the node that makes the whole "fully automated" music video workflow actually work. VRGDG_Qwen2.5 runs a Qwen instruction model locally inside ComfyUI and uses it to turn your lyrics and creative direction into the per-scene prompt maps that the rest of the pack consumes. No API, no key, no cloud - it downloads a model and runs it on your GPU.
The name is a small lie you should know about up front: it says "Qwen 2.5," and the presets are all Qwen2.5 variants - but the default model_preset value shown in the schema is Qwen/Qwen3.5-4B, a string that isn't in the preset list at all. That's a leftover default from a newer model line, and it's a sign this node is evolving fast. Pick a preset from the actual list rather than trusting the default, and you'll be fine.
How it works
Pick a model, pick a task, give it your input, and read the text output. The inputs that matter:
model_preset-Qwen/Qwen2.5-VL-3B-Instruct,Qwen/Qwen2.5-VL-7B-Instruct,Qwen/Qwen2.5-3B-Instruct,Qwen/Qwen2.5-7B-Instruct,Qwen/Qwen2.5-14B-Instruct, orcustom. The VL (vision-language) models can look at images - that's how the workflow keeps your reference character in mind. The 3B models fit comfortably on midrange cards; 14B wants serious VRAM.custom_model_id- override with any Hugging Face repo id or a local model folder path. If you have a quantized local model, point at it here.task_preset-text_to_image,text_to_video,image_to_video,image_edit,captioner_training, orcustom. Each ships built-in instructions tailored to that job; the captioner one is for building training captions and is wheretrigger_word(a LoRA trigger token) gets used.custom_instructions- your own full instruction block, used only when the task iscustom.user_input- your actual task details and creative direction.image_count- how many optional image inputs to reveal, 0 to 24. Set 1โ4 and the node showsimage1โฆimageNports for reference images (the VL models use them).download_if_missing- allow the node to fetch missing models intoComfyUI/models/LLM/Qwen. First run with this on is a big download; plan accordingly.device(auto/cuda/cpu),dtype(autorecommended),temperature(0.6 default),top_p(0.95),max_new_tokens(800 default, up to 32000).
Outputs: text (the generated response), used_model (which model actually ran - the honest answer to "what am I really running"), and status (a string describing the run).
The workflow fit
In the shipped music video workflow, the flow is: lyric transcription โ the template builder and prompt creator hand creative direction to this node โ it writes the scene prompt map โ the fixer repairs it โ the splitters hand scenes to the video generators. The community's reports on the pack confirm the LLM-driven flow: "it utilizes LLM for prompts, fully automated," and the automated prompts come out surprisingly coherent until you hit character consistency. If you're going to review anything before a long render, review what this node produced.
Gotchas
- VRAM is the whole game. 14B is a lot; if you're on 8โ12GB, stick with 3B or 7B and let
dtype: autopick the precision. Watch ComfyUI's console on first run - a missing-model error meansdownload_if_missingwas off. - The default preset string is stale (see above). It says
Qwen3.5-4Bwhich isn't in the list - choose explicitly. - 24 image inputs is overkill for any real workflow. Set
image_countto what you actually have (usually 1) to keep the node sane.
Installing it
It's the flagship node of the pack, so install the pack:
cd ComfyUI/custom_nodes
git clone https://github.com/vrgamegirl19/comfyui-vrgamedevgirl
restart ComfyUI, or use ComfyUI Manager โ search vrgamedev. Then enable download_if_missing and let the first run pull the model into ComfyUI/models/LLM/Qwen - or download it manually to that folder. The pack's requirements.txt (kornia, librosa, imageio) covers the workflow's audio and image side; the node itself uses ComfyUI's bundled transformers stack.
The honest take
This is the highest-impact node in the pack and the heaviest one. It's the difference between "I typed a brief" and "I typed a brief and got thirty coherent scene prompts." If you only care about the video-enhancement half of this repo, skip it; if you're here for the music video workflow, it's the engine.
Inputs (37)
| Name | Type | Default | Description |
|---|---|---|---|
| model_preset | COMBO | Qwen/Qwen3.5-4B | Choose a model preset. Use custom_model_id to override this. |
| custom_model_id | STRING | Optional override. Can be a Hugging Face repo id or a local model folder path. | |
| task_preset | COMBO | text_to_image | Select a task preset with built-in instructions. |
| custom_instructions | STRING | Used only when task_preset is custom. Enter your own full instruction block. | |
| user_input | STRING | Your task details and creative direction for the selected preset. | |
| trigger_word | STRING | Optional LoRA/training trigger token. Used only by Captioner preset. | |
| image_count | INT | 00โ24 | How many optional image inputs to show on the node. |
| download_if_missing | BOOLEAN | false | If enabled, missing models can be downloaded to ComfyUI/models/LLM/Qwen. |
| device | COMBO | auto | Inference device selection. |
| dtype | COMBO | auto | Inference precision. Auto is recommended. |
| temperature | FLOAT | 0.600โ2 | Higher = more creative variation, lower = more deterministic output. |
| top_p | FLOAT | 0.950โ1 | Nucleus sampling cutoff. |
| max_new_tokens | INT | 80032โ32000 | Maximum number of output tokens. |
| image1opt | IMAGE | Optional reference image input. | |
| image2opt | IMAGE | Optional reference image input. | |
| image3opt | IMAGE | Optional reference image input. | |
| image4opt | IMAGE | Optional reference image input. | |
| image5opt | IMAGE | Optional reference image input. | |
| image6opt | IMAGE | Optional reference image input. | |
| image7opt | IMAGE | Optional reference image input. | |
| image8opt | IMAGE | Optional reference image input. | |
| image9opt | IMAGE | Optional reference image input. | |
| image10opt | IMAGE | Optional reference image input. | |
| image11opt | IMAGE | Optional reference image input. | |
| image12opt | IMAGE | Optional reference image input. | |
| image13opt | IMAGE | Optional reference image input. | |
| image14opt | IMAGE | Optional reference image input. | |
| image15opt | IMAGE | Optional reference image input. | |
| image16opt | IMAGE | Optional reference image input. | |
| image17opt | IMAGE | Optional reference image input. | |
| image18opt | IMAGE | Optional reference image input. | |
| image19opt | IMAGE | Optional reference image input. | |
| image20opt | IMAGE | Optional reference image input. | |
| image21opt | IMAGE | Optional reference image input. | |
| image22opt | IMAGE | Optional reference image input. | |
| image23opt | IMAGE | Optional reference image input. | |
| image24opt | IMAGE | Optional reference image input. |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| text | STRING | โ |
| used_model | STRING | โ |
| status | STRING | โ |