Nodes/IAMCCS-nodes/IAMCCS Cine H3 Vision Info - Local VLM
ComfyUI Node

IAMCCS Cine H3 Vision Info - Local VLM

A local VLM that reads your reference frames like a script supervisor

By IAMCCS·Created 11 months ago·Updated 4 days ago· 113
IAMCCS Cine H3 Vision Info - Local VLM
  • cine_linx
  • clip
  • image_1
  • image_2
  • image_3
  • image_4
  • cine_linx
analysis_modeh3_prompt_ready
analysis_targetglobal
context_merge_policyappend
template_modeqwen3_vl_labeled
image_role_1opening_frame
image_target_1analysis_target
image_role_2closing_frame
image_target_2analysis_target
image_role_3subject_identity
image_target_3analysis_target
image_role_4style_lighting
image_target_4analysis_target
analysis_max_side768
seed0
temperature0.20
max_tokens768
prompt_enhance_modecontext_only
release_vlm_after_analysistrue
custom_analysis_prompt
user_direction
prepared_analysis

The name is a lie in the best possible way: "Vision Info" doesn't call any API and needs no key. This node runs a local vision-language model - a generative Qwen3-VL loaded through ComfyUI's CLIPLoader - over up to four reference images, and writes prompt-ready continuity notes into your cine_linx bus for the MiniMax H3 prompter. Instead of you squinting at an opening frame and hand-transcribing "subject stands camera-left, warm key, shallow DOF" into the prompt, the VLM does it, phrased the way H3 likes it, with role-specific instructions telling it what to extract and what to leave alone.

It's the difference between "describe this image" and "tell me what the opening-frame authority requires at 0.00 seconds." Each of the four image slots gets a role - opening_frame, closing_frame, subject_identity, subject_performance, wardrobe_prop, environment, composition_camera, style_lighting, generic_reference, or disabled - and an injection target (global, or one of local_1..3 / local_auto) deciding where in the shotboard prompt its findings land. The analysis_mode preset (h3_prompt_ready, identity_continuity, subject_performance, scene_geography, camera_light_composition, wardrobe_props, custom) swaps in a rule block. Pick identity_continuity and the VLM is told to extract only stable visible identity evidence and not invent biography; pick scene_geography and it becomes a continuity-tracking pass on screen direction and set geography. Same images, completely different analysis, all through prompt engineering on the VLM's side.

The inputs you'll actually touch:

  • image_1..image_4 plus their role/target pairs - defaults are opening frame, closing frame, subject identity, style/lighting. Set disabled on any slot you don't need.
  • clip - connect your Qwen3-VL generative CLIP here. The pack recommends qwen3vl_4b_fp8_scaled.safetensors; it validates the CLIP exposes Qwen3-VL family markers and errors loudly with the exact filename if you load something else.
  • temperature / max_tokens / seed - generation knobs. Defaults (0.2 / 768) are already conservative; crank temperature only if the output reads too stiff.
  • release_vlm_after_analysis (default on) - frees the VLM after the pass so it isn't hogging VRAM when the H3 sampler needs it. Leave it on.
  • prepared_analysis - the escape hatch. Connect pre-written analysis text and the node skips running the VLM entirely. Great for iterating on prompt phrasing without paying the vision-model tax, and it's your only option if you don't want to install a Qwen3-VL repack at all.

Output is a single cine_linx - the analysis travels inside the bus and the images are deliberately not retained after the pass, which keeps the envelope lean.

Installation is the pack story (search IAMCCS in ComfyUI Manager, or git clone https://github.com/IAMCCS/IAMCCS-nodes.git into custom_nodes, restart). The model story is separate: you need a Qwen3-VL instruct text-encoder repack on disk, loadable by ComfyUI's standard text-encoder loaders. The MiniMax H3 workflow requirements doc also expects ComfyUI-GGUF if you load Qwen3-VL from GGUF.

Where people get burned: connecting a non-Qwen3-VL CLIP and getting a hard validation error (the fix is in the error message), forgetting that release_vlm_after_analysis exists and wondering why a 22B H3 run OOMs on a warm cache, and treating h3_prompt_ready output as a literal final prompt - it's input material for the prompter, not a finished shot description. Read it, fix it, then let H3 cook.

CategoryIAMCCS/MiniMax H3/Prompting

Inputs (27)

NameTypeDefaultDescription
analysis_modeCOMBOh3_prompt_ready7 options: h3_prompt_ready, identity_continuity, subject_performance, scene_geography, camera_light_composition, wardrobe_props, +1
analysis_targetCOMBOglobal5 options: global, local_auto, local_1, local_2, local_3
context_merge_policyCOMBOappend2 options: append, replace
template_modeCOMBOqwen3_vl_labeled2 options: qwen3_vl_labeled, model_default
image_role_1COMBOopening_frame10 options: opening_frame, closing_frame, subject_identity, subject_performance, wardrobe_prop, environment, +4
image_target_1COMBOanalysis_target7 options: analysis_target, global, local_auto, local_1, local_2, local_3, +1
image_role_2COMBOclosing_frame10 options: opening_frame, closing_frame, subject_identity, subject_performance, wardrobe_prop, environment, +4
image_target_2COMBOanalysis_target7 options: analysis_target, global, local_auto, local_1, local_2, local_3, +1
image_role_3COMBOsubject_identity10 options: opening_frame, closing_frame, subject_identity, subject_performance, wardrobe_prop, environment, +4
image_target_3COMBOanalysis_target7 options: analysis_target, global, local_auto, local_1, local_2, local_3, +1
image_role_4COMBOstyle_lighting10 options: opening_frame, closing_frame, subject_identity, subject_performance, wardrobe_prop, environment, +4
image_target_4COMBOanalysis_target7 options: analysis_target, global, local_auto, local_1, local_2, local_3, +1
analysis_max_sideINT768256–1536
seedINT00–4294967295
temperatureFLOAT0.200–1.5
max_tokensINT768128–4096
prompt_enhance_modeCOMBOcontext_only2 options: context_only, enhance_visual_context
release_vlm_after_analysisBOOLEANtrue
cine_linxoptIAMCCS_SUPERNODE_LINX
clipoptCLIP
image_1optIMAGE
image_2optIMAGE
image_3optIMAGE
image_4optIMAGE
custom_analysis_promptoptSTRING
user_directionoptSTRINGUsed only when prompt_enhance_mode=enhance_visual_context.
prepared_analysisoptSTRINGOptional pre-generated vision description. When connected, it is used instead of running the local VLM.

Outputs (1)

NameTypeDescription
cine_linxIAMCCS_SUPERNODE_LINX