gguf-vision-check

Detect vision support in GGUF models and locate mmproj files on HuggingFace.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/crycriM/hermes-skills --skill gguf-vision-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gguf-vision-check
Source: https://github.com/crycriM/hermes-skills/tree/main/mlops/gguf-vision-check
Command: npx skills add https://github.com/crycriM/hermes-skills --skill gguf-vision-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers determine whether a GGUF model includes vision input support, and if a separate mmproj vision encoder exists in the same HuggingFace repo, enabling correct multimodal deployment with llama.cpp.

Core Features & Use Cases

  • Vision support detection: identify vision-related keys and tensors in the main GGUF and locate any accompanying mmproj files.
  • Repository validation: assess HuggingFace repo listings to confirm a mmproj file is present for VL-capable models.
  • Use Case: accelerate setup of multimodal inference pipelines by ensuring both main GGUF and the vision mmproj are available before serving.

Quick Start

Use this skill to verify a local GGUF file's vision support and locate its mmproj companion.

Frequently Asked Questions about gguf-vision-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a GGUF model supports vision input for multimodal inference?

To check GGUF vision support, inspect the main GGUF file for vision-related keys and tensors that indicate multimodal capabilities. This validation confirms whether the model can process image inputs.

What is an mmproj file and do I need it for llama.cpp multimodal deployment?

An mmproj file is the companion vision encoder required for multimodal deployment with llama.cpp. For VL-enabled GGUF models, you need both the main GGUF and its matching mmproj file to serve vision inputs correctly.

How do I find the mmproj companion file for a GGUF model on HuggingFace?

To find the mmproj companion on HuggingFace, assess the repository file listings to confirm a corresponding mmproj file exists alongside the main GGUF. This automates the repository validation process.

Can I use a vision-capable GGUF model in llama.cpp without the mmproj file?

No, serving vision inputs in llama.cpp requires the mmproj vision encoder alongside the main GGUF. Without the mmproj file present in the HuggingFace repo, the multimodal inference pipeline cannot process images.

Why does my multimodal GGUF model fail to accept image inputs in llama.cpp?

Multimodal GGUF models fail to accept images in llama.cpp when the mmproj vision encoder is missing. Validate presence of vision indicators in the main GGUF and confirm the corresponding mmproj file exists before serving.