Auto-wire llama.cpp --mmproj for VL models (zero-config vision)#90
Merged
Conversation
GGUF vision models ship a co-located mmproj-*.gguf projector and llama-server needs --mmproj to accept images, but the deploy never passed it, so VL models served text only unless the user manually added `--config mmproj=<path>`. On deploy, when the engine is llamacpp and the model format is gguf, look for a co-located mmproj-*.gguf next to the model file (preferring an f16 projector) and inject its path as the `mmproj` config (flows through configToFlags as --mmproj). Skipped when the caller already set mmproj or no projector is present, so plain LLMs are unaffected. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
rjckkkkk
added a commit
that referenced
this pull request
Jun 12, 2026
) New version-stamped build aima-windows-amd64-v0.5-dev-amd-strix-halo-20260612.exe (source commit fa35aa4) on top of the HIP-engine build. Adds, vs the 20260610 exe: #87 native deploy readiness uses the real runtime name (no false "not ready") #88 deploy launcher hidden (no cmd.exe console popup) via VBS launcher #89 Qwen2.5-VL-3B-Instruct catalog knowledge (vlm + aliases + verified perf) #90 zero-config vision: llama.cpp --mmproj auto-wired for VL gguf models #91 openclaw sync preflight-probes :6188 and warns loudly when unreachable serve.bat now points at the 20260612 exe; older builds kept for rollback. README build table + fixes list + OpenClaw data-plane guidance updated. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
On deploy, when the engine is llamacpp and the model is gguf, auto-detect a co-located
mmproj-*.ggufprojector (preferring f16) next to the model and inject it as themmprojconfig → llama-server gets--mmproj <path>→ image input works with no manual config.Why
GGUF VL models (e.g. Qwen2.5-VL) ship the LLM gguf + an mmproj projector;
llama-serverneeds--mmprojto enable vision. The deploy command never passed it, so VL models served text only unless the user manually added--config mmproj=<path>. Skipped whenmmprojis already set or no projector is present → plain LLMs unaffected.Verified (AMD Strix Halo Win11, llama.cpp b9330)
aima deploy Qwen2.5-VL-3B-Instruct-Q4_K_M --engine llamacpp(no mmproj config) → logauto-wired multimodal projector, command gained--mmproj …mmproj-…-f16.gguf, deploy ready, and sending a solid-color image returned the correct color ("Green", "Blue").🤖 Generated with Claude Code