| # 🧩 ComfyUI-QwenVL — Custom Models Guide | |
| You can add your own HuggingFace or local fine-tuned QwenVL models | |
| without modifying the main code. | |
| --- | |
| ## 📁 File location | |
| Place a file named `custom_models.json` in this folder: | |
| ``` | |
| ComfyUI/custom_nodes/ComfyUI-QwenVL/ | |
| ```` | |
| When ComfyUI starts, it will automatically detect and merge this file | |
| with the default `config.json`. | |
| --- | |
| ## ⚙️ File format | |
| Use the following JSON structure: | |
| ```json | |
| { | |
| "hf_models": { | |
| "My QwenVL Finetune": { | |
| "repo_id": "myusername/MyQwenVL-Finetune", | |
| "default": false, | |
| "quantized": false, | |
| "vram_requirement": { | |
| "4bit": 4, | |
| "8bit": 6, | |
| "full": 10 | |
| } | |
| }, | |
| "QwenVL Mini 4bit": { | |
| "repo_id": "huggingface-user/qwenvl-mini-4bit", | |
| "default": false, | |
| "quantized": false, | |
| "vram_requirement": { | |
| "4bit": 2, | |
| "8bit": 4, | |
| "full": 8 | |
| } | |
| } | |
| } | |
| } | |
| ```` | |
| * The **key** (e.g. `"My QwenVL Finetune"`) is what appears in the model dropdown list. | |
| * `"repo_id"` can be a HuggingFace model name or a local directory path. | |
| * `"vram_requirement"` is optional but helps ComfyUI display VRAM recommendations. | |
| --- | |
| ## 🧠 Notes | |
| * If `custom_models.json` doesn’t exist, the system just skips it (no errors). | |
| * You can edit and reload it anytime — simply restart ComfyUI to apply changes. | |
| * Compatible with both Qwen2-VL and Qwen3-VL model architectures. | |