NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
MLX-VLM is a package for inference and fine-tuning of Vision Language Models (VLMs) and Omni Models (VLMs with audio and video support) on your Mac using MLX.
Latest stable
0.7.12
Last release 11 days ago
04 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
93 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
Add support for Gemma 3 by @pcuenca @FL33TW00D and @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/235
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.16...v0.1.17
Fix aya vision 32b by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/226
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.15...v0.1.16
add status badge by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/215
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.14...v0.1.15
Fix generate() call in object_detection.ipynb to follow the latest parameter order by @JoeJoe1313 in https://github.com/Blaizzy/mlx-vlm/pull/200
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.13...v0.1.14
Add Video Understanding Support (beta) by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/97
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.12...v0.1.13
Add support for Qwen2-5-VL by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/189
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.11...v0.1.12
Chat in CLI. by @chigkim in https://github.com/Blaizzy/mlx-vlm/pull/168
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.10...v0.1.11
Corrected order of parameters on example by @bbaaxx in https://github.com/Blaizzy/mlx-vlm/pull/169
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.9...v0.1.10
Fix pixtral LM only and tokenizer loading for DS-VL2 by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/165
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.8...v0.1.9
Fix idefics3 vision model type checking by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/164
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.7...v0.1.8
This release introduces some breaking changes. If you encounter any issues, please open an issue or submit a PR.
This release introduces some breaking changes. If you encounter any issues, please open an issue or submit a PR.
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.6...v0.1.7
Fixes DeepSeek quant loading by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/156
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.5...v0.1.6
Add support for Deepseek-vl2 by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/153
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.4...v0.1.5
Add support for Paligemma-2 by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/142
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.3...v0.1.4
Add lazy eval during conversion by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/127
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.2...v0.1.3
Fix padding type casting by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/125
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.1...v0.1.2
Add example notebooks and support for system role by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/95
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.1.0...v0.1.1
Add support for Pixtral-12B by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/67
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.15...v0.1.0
Qwen2-VL fix vision tower bug for HD imagges by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/62
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.14...v0.0.15
Add support for Qwen2-VL by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/59
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.13...v0.0.14
fix chat template bug by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/55
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.12...v0.0.13
Refactor KVCache and add stream generate by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/53
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.11...v0.0.12
Add Dolphin-vision and Bunny by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/50
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.10...v0.0.11
Add support for phi-3-vision-128k-instruct by @JosefAlbers in https://github.com/Blaizzy/mlx-vlm/pull/36
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.9...v0.0.10
Add support for Llava-Next (v1.6) by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/43
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.8...v0.0.9
Update load_image function to handle BytesIO input by @gabewillen in https://github.com/Blaizzy/mlx-vlm/pull/34
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.7...v0.0.8
Fix idefics2 OCR by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/31
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.6...v0.0.7
Add support for PaliGemma and Quant Siglip by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/24
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.5...v0.0.6
Better error message for non safetensor repository by @IamShubhamGupto in https://github.com/Blaizzy/mlx-vlm/pull/15
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.4...v0.0.5
Update image processor by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/7
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.3...v0.0.4
Fix hf-to-mlx conversion and quantization by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/6
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.2...v0.0.3
Update docs by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/4
Full Changelog: https://github.com/Blaizzy/mlx-vlm/compare/v0.0.1...v0.0.2
API redesign for v0.0.1 by @Blaizzy in https://github.com/Blaizzy/mlx-vlm/pull/2
Full Changelog: https://github.com/Blaizzy/mlx-vlm/commits/v0.0.1
One column per month.