Module mmproj 

Detect mmproj-*.gguf vision towers next to a main GGUF (P7).

Ferrox does not yet run VL e2e — this helper only discovers companion projector files the way OpenAI-style multimodal loaders expect, so serve/CLI can fail closed with a clear path once vl_engine lands.

Functions

eprint_mmproj_if_present

CLI-facing stderr variant of warn_mmproj_if_present.

find_mmproj_beside

Look for mmproj*.gguf (case-insensitive) in the same directory as main_gguf. Returns the first match by name, if any.

warn_mmproj_if_present

Log a clear warning when a companion mmproj exists but VL is not implemented. Known VL architectures get a stronger message (fail-closed hint for operators).