This is an
8-bit quantized MLX conversion of
inclusionAI/ZwZ-4B, optimized for Apple Silicon inference using the
MLX framework.
ZwZ-4B is a fine-grained multimodal perception model built on
Qwen3-VL-4B, trained using Region-to-Image Distillation (R2I) combined with reinforcement learning. It achieves state-of-the-art fine-grained visual understanding among models of comparable size in a single forward pass — no inference-time zooming or tool calling required.
The 4B 8-bit variant offers a good balance of compact size and higher quantization fidelity compared to the 4-bit version.
Only the language model / text decoder layers are quantized. The following module paths are excluded from quantization and remain at their original precision:
Benchmarked on Apple M2 Max, 96 GB unified memory.
1python -m mlx_vlm.generate \
2 --model swaylenhayes/ZwZ-4B-VL-MLX-8bit \
3 --max-tokens 512 \
4 --temperature 0.0 \
5 --prompt "Describe this image in detail." \
6 --image path/to/image.png
1from mlx_vlm import load, generate
2from mlx_vlm.prompt_utils import apply_chat_template
3from mlx_vlm.utils import load_config
4
5model_path = "swaylenhayes/ZwZ-4B-VL-MLX-8bit"
6model, processor = load(model_path)
7config = load_config(model_path)
8
9prompt = apply_chat_template(
10 processor,
11 config,
12 "List every interactive UI element visible in this screenshot.",
13 num_images=1,
14)
15
16output = generate(
17 model,
18 processor,
19 prompt,
20 image="path/to/screenshot.png",
21 max_tokens=512,
22 temperature=0.0,
23)
24print(output)
1curl http://127.0.0.1:8108/v1/chat/completions \
2 -H "Content-Type: application/json" \
3 -d '{
4 "model": "default",
5 "messages": [{"role": "user", "content": "Reply with OK"}],
6 "max_tokens": 16
7 }'
ZwZ transforms zooming from an inference-time tool into a training-time primitive:
This makes ZwZ particularly well-suited for tasks requiring fine visual detail recognition, such as UI screenshot parsing, document analysis, and dense image understanding.
1@article{wei2026zooming,
2 title={Zooming without Zooming: Region-to-Image Distillation for Fine-Grained Multimodal Perception},
3 author={Wei, Lai and He, Liangbo and Lan, Jun and Dong, Lingzhong and Cai, Yutong and Li, Siyuan and Zhu, Huijia and Wang, Weiqiang and Kong, Linghe and Wang, Yue and Zhang, Zhuosheng and Huang, Weiran},
4 journal={arXiv preprint arXiv:2602.11858},
5 year={2026}
6}
Apache 2.0 — follows the license of the original ZwZ and Qwen3-VL models.