jcbtc's picture
Add opt-in vision flag, F16 projector, provenance and image smoke validation
eb46b09 verified
|
Raw
History Blame
2.09 kB

Optional vision projector

Enable image input with bash ./model/run-server.sh --vision and the same RUNTIME_DIR / BUILD_DIR used for text serving. ENABLE_VISION=1 is equivalent. To use a different projector location, set MMPROJ.

mmproj-Qwen3.8-Flash-F16.mmproj is a GGUF-format projector converted directly from the pinned original Qwen checkpoint with the CIRU v3 converter. Conversion produces 334 tensors, with clip architecture, qwen3vl_merger projector type, and projection dimension 2560 matching the language model.

The .mmproj extension avoids confusing Hub model-size detection with a second standalone GGUF model. The runtime reads the GGUF header regardless of filename extension.

  • Precision: F16 conversion, with converter-selected F32 tensors retained.
  • File size: 904,004,320 bytes.
  • SHA-256: db643482521c722ff1074afd5018c060ef6ce9b828421c7cfc27b2f235c2569b.
  • License: the repository's existing Qwen Community License applies.

Reproduction, using a local copy of the pinned source checkpoint:

python3 ciru-runtime/convert_hf_to_gguf.py /path/to/pinned-qwen-source \
  --mmproj --outtype f16 \
  --outfile mmproj-Qwen3.8-Flash-F16.mmproj

Verify the downloaded file from this directory with sha256sum -c SHA256SUMS. Machine-readable provenance.

Validation

On Ciru (Ryzen AI Max+ 395, gfx1151, 128 GB shared memory, NixOS/ROCm 10), the released launcher loaded this projector with the existing CIRU v3 runtime, a 262,144-token context, one slot, and MTP depth 6. Two separate OpenAI-compatible image requests returned red square and Blue circle for corresponding synthetic images. These are functional smoke tests, not a vision benchmark or a claim about OCR, detailed reasoning, or video quality. The text-only benchmark tables on the main card remain text-only measurements. Validation record.