Fix false Qwen3-VL detection when mmproj is not required

Author: kantan-kanto

.gitignore

@@ -51,3 +51,5 @@ Thumbs.db
 # ComfyUI specific
 output/
 temp/
+
+experiments/

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to ComfyUI-MultiModal-Prompt-Nodes will be documented in thi
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.7] - 2026-01-26
+
+### Fixed
+- Fixed incorrect detection of Qwen3-VL when mmproj is set to (Not required).
+  - Disabled automatic mmproj detection and prevented use of the VL handler in this case.
+  - Updated GGUFModelManager.load_model and node-side mmproj interpretation to correctly respect (Not required).
+
 ## [1.0.6] - 2026-01-16
 
 ### Fixed

README.md

@@ -472,9 +472,5 @@ Areas needing help:
 
 See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
 
-### Current Version: 1.0.6
-- Improved stability when switching between Qwen3-VL GGUF models
-- Fixed mmproj reuse issues in local vision models
-- Internal structure preparation for future backend refactoring
-- Documentation updates clarifying project scope, installation notes, and attribution
-- No breaking changes to node interfaces
+### Current Version: 1.0.7
+- Fixed incorrect detection of Qwen3-VL when mmproj is set to (Not required).

__init__.py

@@ -6,7 +6,7 @@
 # the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 
-__version__ = "1.0.6"
+__version__ = "1.0.7"
 
 from .qwen_nodes import NODE_CLASS_MAPPINGS as qNODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS as qNODE_DISPLAY_NAME_MAPPINGS
 from .wan_nodes import NODE_CLASS_MAPPINGS as wNODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS as wNODE_DISPLAY_NAME_MAPPINGS

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "multimodal-prompt-nodes"
 description = "Multimodal prompt generator nodes for ComfyUI, designed to generate prompts for QwenImageEdit and Wan2.2. Supports local LLM / local GGUF models (Qwen3-VL, Qwen-VL) and Qwen API for image and video prompt generation and enhancement."
-version = "1.0.6"
+version = "1.0.7"
 license = {file = "LICENSE"} 
 # classifiers = [
 #     # For OS-independent nodes (works on all operating systems)

vision_llm_node.py

@@ -281,8 +281,13 @@ def load_model(
         # Infer Qwen version from model name
         is_qwen3 = self._infer_is_qwen3(model_path)
 
-        # Qwen3-VL requires mmproj
-        if is_qwen3:
+        # If user explicitly selected "(Not required)", force text-only even if the filename contains "qwen3".
+        # This prevents accidental Qwen3-VL handler selection and mmproj auto-detection for text-only Qwen3 models.
+        force_no_mmproj = (mmproj_path == "(Not required)")
+        if force_no_mmproj:
+            mmproj_path = None
+        # Qwen3-VL requires mmproj (unless explicitly disabled)
+        if is_qwen3 and not force_no_mmproj:
             if mmproj_path is None:
                 mmproj_path = self._auto_detect_mmproj(model_path)
                 if mmproj_path is None:
@@ -625,7 +630,10 @@ def rewrite(self, prompt: str, model: str, mmproj: str, style: str, target_langu
 
             # mmproj processing
             mmproj_path = None
-            if mmproj not in ["(Auto-detect)", "(Not required)"]:
+            if mmproj == "(Not required)":
+                # Sentinel to force text-only (prevents mmproj auto-detect / VL handler)
+                mmproj_path = "(Not required)"
+            elif mmproj != "(Auto-detect)":
                 mmproj_path = os.path.normpath(os.path.join(models_dir, mmproj))
                 if not os.path.exists(mmproj_path):
                     print(f"[Vision LLM Node] Warning: mmproj not found: {mmproj_path}")