MLX Patch Comparison Report

maclocal-api commit 038ba82 (main) — 2026-03-02
Upstream mlx-swift-lm: pinned 2.30.3 (2c70054) · latest tag 2.30.6 · main 3a7f2b1
  pinned→latest: 21 commits · latest→main: 7 commits
Upstream mlx-swift: pin 0.30.3 · latest tag 0.30.6 · main a2f0d76
Generated: 2026-03-02 14:11:45
Command: ./Scripts/gen-patch-comparison.sh
20
Patch Files
10
No Conflict
9
Low/Med Risk
1
High Risk
10
New Files

File-by-File Comparison

File Target Type maclocal-api (038ba82) vs Pinned (2.30.3) vs Latest Tag (2.30.6) vs Main (3a7f2b1) Risk maclocal-api Features
Qwen3VL.swift MLXVLM MODIFIED 1787L CHANGED 1766L (+35/-14) CHANGED 1766L (+38/-17) CHANGED 1766L (+38/-17) LOW Qwen3 VL patches
Qwen3Next.swift MLXLLM NEW 723L N/A CHANGED 800L (+347/-424) CHANGED 802L (+348/-427) LOW GatedDeltaNet model architecture
GatedDelta.swift MLXLLM NEW 449L N/A N/A N/A NONE GatedDeltaNet attention layer
Qwen3_5MoE.swift MLXLLM NEW 1012L N/A N/A N/A NONE Fused QKV/GDN/gate+up projections; fusedSiluMul Metal kernel; MLXFast.rmsNorm; adaptive sanitize
DeepseekV3.swift MLXLLM MODIFIED 717L CHANGED 563L (+202/-48) CHANGED 563L (+204/-50) CHANGED 563L (+204/-50) LOW Bug fixes; Kimi K2 reuse
MiniMaxM2.swift MLXLLM NEW 362L N/A N/A N/A NONE MiniMax M2 model architecture
NemotronH.swift MLXLLM NEW 1008L N/A CHANGED 1003L (+8/-3) CHANGED 1003L (+8/-3) LOW NemotronH hybrid Mamba+Attention model
GLM4MoeLite.swift MLXLLM NEW 662L N/A N/A N/A NONE GLM-4 MoE Lite model
GLM5MoeDsa.swift MLXLLM NEW 866L N/A N/A N/A NONE GLM-5 MoE DSA model
KimiK25.swift MLXLLM NEW 113L N/A N/A N/A NONE Kimi K2.5 model architecture
LLMModelFactory.swift MLXLLM MODIFIED 584L CHANGED 554L (+31/-1) CHANGED 568L (+33/-17) CHANGED 570L (+36/-22) LOW qwen3_5_moe/kimi_k2/kimi_k25/joyai_llm_flash/glm_moe_dsa/minimax_m2; sanitizeJSON(); toolCallFormat removal
Load.swift MLXLMCommon MODIFIED 121L CHANGED 105L (+20/-4) CHANGED 105L (+20/-4) CHANGED 110L (+25/-14) LOW .jinja/.tiktoken downloads; MXFP4 fix; relaxed weight verification
Evaluate.swift MLXLMCommon MODIFIED 1451L CHANGED 1044L (+430/-23) CHANGED 1349L (+592/-490) CHANGED 1371L (+591/-511) HIGH TopK/MinP/Presence/Composite processors; seed; logprobs; AFM_PERF; clearCache; shouldQuantizeCache
Tokenizer.swift MLXLMCommon MODIFIED 429L CHANGED 157L (+272/-0) CHANGED 157L (+272/-0) CHANGED 157L (+272/-0) NONE TikToken support; .jinja fallback; O(n) window trim
Qwen3_5MoEVL.swift MLXVLM NEW 1449L N/A N/A N/A NONE Qwen3.5 MoE VLM wrapper
VLMModelFactory.swift MLXVLM MODIFIED 398L CHANGED 390L (+10/-2) CHANGED 396L (+3/-1) CHANGED 408L (+8/-18) LOW Qwen3.5 MoE VL registration
SamplerTests.swift Tests NEW 404L N/A N/A N/A NONE Unit tests for sampling processors
ToolCallFormat.swift MLXLMCommon MODIFIED 113L N/A CHANGED 120L (+11/-18) CHANGED 120L (+11/-18) MEDIUM Qwen3 model type detection (qwen3_next, qwen3_coder)
KVCache.swift MLXLMCommon MODIFIED 1610L CHANGED 1585L (+36/-11) CHANGED 1585L (+36/-11) CHANGED 1578L (+55/-23) LOW 2x growth strategy; Updatable protocol; MXFP4 mode parameter
SwitchLayers.swift MLXLMCommon MODIFIED 354L CHANGED 200L (+163/-9) CHANGED 200L (+163/-9) CHANGED 200L (+163/-9) NONE fusedSiluMul Metal kernel; SwitchGLU gate+up fusion; memory headroom check

mlx-swift Framework: 0.30.3 → 0.30.6 → main

0.30.3 → 0.30.6 (8 commits):
6ba4827 update for mlx v0.30.6 (#353) c2a5f12 Add wired memory (#352) 5a7b694 Weakly link error domains to allow building non-Metal-supporting targets (#354) 1258900 Add release workflow that builds and attaches XCFramework assets (#351) 30d0b9b Wired Memory Management System (#348) 87c9f8d Add skill.md (#350) a1bf450 adds a note to get the submodules if you're building locally (#346) f688d89 Support for building through SwiftPM on Linux (CPU only) (#304)
0.30.6 → main (4 commits):
a2f0d76 Fix dictionary key lookup in Module.update(parameters:) (#363) 2755373 Fix wired mem race condition (#358) 0cc7956 Use CXX 20, since MLX-C uses C++ 20 code (#357) d3d0a5b add gh for the release build (#356)

Upstream-Only Files (Not in maclocal-api Patches)

Files present in upstream mlx-swift-lm that are not covered by any maclocal-api patch. These may represent new model architectures or features available for adoption.
File Library Since Pinned (2.30.3) Latest Tag (2.30.6) Main (3a7f2b1)
AfMoE.swift MLXLLM/Models pinned 601L 591L 591L
Apertus.swift MLXLLM/Models pinned 483L 483L 483L
BaichuanM1.swift MLXLLM/Models pinned 300L 300L 300L
BailingMoe.swift MLXLLM/Models pinned 367L 367L 367L
Bitnet.swift MLXLLM/Models pinned 499L 499L 499L
Cohere.swift MLXLLM/Models pinned 240L 240L 240L
Ernie4_5.swift MLXLLM/Models pinned 236L 236L 236L
Exaone4.swift MLXLLM/Models pinned 305L 305L 305L
FalconH1.swift MLXLLM/Models pinned 758L 758L 758L
Gemma.swift MLXLLM/Models pinned 237L 237L 237L
Gemma2.swift MLXLLM/Models pinned 279L 279L 279L
Gemma3nText.swift MLXLLM/Models pinned 1040L 1056L 1056L
Gemma3Text.swift MLXLLM/Models pinned 433L 445L 445L
GLM4.swift MLXLLM/Models pinned 281L 281L 281L
GLM4MOE.swift MLXLLM/Models pinned 453L 453L 453L
GLM4MOELite.swift MLXLLM/Models latest — 724L 724L
GPTOSS.swift MLXLLM/Models pinned 548L 548L 548L
Granite.swift MLXLLM/Models pinned 287L 287L 287L
GraniteMoeHybrid.swift MLXLLM/Models pinned 711L 711L 711L
Internlm2.swift MLXLLM/Models pinned 328L 328L 328L
Jamba.swift MLXLLM/Models pinned 581L 581L 581L
LFM2.swift MLXLLM/Models pinned 411L 411L 417L
LFM2MoE.swift MLXLLM/Models pinned 497L 497L 503L
Lille130m.swift MLXLLM/Models pinned 247L 247L 247L
Llama.swift MLXLLM/Models pinned 476L 476L 476L
MiMo.swift MLXLLM/Models pinned 276L 276L 276L
MiMoV2Flash.swift MLXLLM/Models latest — 556L 556L
MiniCPM.swift MLXLLM/Models latest — 265L 265L
MiniMax.swift MLXLLM/Models latest — 340L 340L
Mistral3Text.swift MLXLLM/Models pinned 492L 494L 494L
NanoChat.swift MLXLLM/Models pinned 282L 282L 282L
Olmo2.swift MLXLLM/Models pinned 422L 422L 422L
Olmo3.swift MLXLLM/Models pinned 332L 332L 332L
OlmoE.swift MLXLLM/Models pinned 467L 467L 467L
OpenELM.swift MLXLLM/Models pinned 309L 309L 309L
Phi.swift MLXLLM/Models pinned 243L 243L 243L
Phi3.swift MLXLLM/Models pinned 327L 327L 327L
PhiMoE.swift MLXLLM/Models pinned 270L 270L 270L
Qwen2.swift MLXLLM/Models pinned 281L 281L 281L
Qwen3.swift MLXLLM/Models pinned 289L 289L 289L
Qwen35.swift MLXLLM/Models main — — 687L
Qwen35MoE.swift MLXLLM/Models main — — 75L
Qwen3MoE.swift MLXLLM/Models pinned 364L 364L 364L
SmolLM3.swift MLXLLM/Models pinned 375L 375L 375L
SSM.swift MLXLLM/Models pinned 237L 237L 237L
Starcoder2.swift MLXLLM/Models pinned 258L 258L 258L
FastVLM.swift MLXVLM/Models pinned 1183L 1183L 1183L
Gemma3.swift MLXVLM/Models pinned 1178L 1178L 1178L
Idefics3.swift MLXVLM/Models pinned 900L 900L 900L
LFM2VL.swift MLXVLM/Models pinned 1283L 1283L 1283L
Mistral3.swift MLXVLM/Models pinned 1108L 1108L 1108L
Paligemma.swift MLXVLM/Models pinned 738L 738L 738L
Pixtral.swift MLXVLM/Models pinned 1136L 1136L 1136L
Qwen25VL.swift MLXVLM/Models pinned 1095L 1098L 1098L
Qwen2VL.swift MLXVLM/Models pinned 922L 926L 926L
Qwen35.swift MLXVLM/Models main — — 1252L
Qwen35MoE.swift MLXVLM/Models main — — 47L
QwenVL.swift MLXVLM/Models pinned 258L 258L 258L
SmolVLM2.swift MLXVLM/Models pinned 362L 363L 363L
AttentionUtils.swift MLXLMCommon pinned 77L 77L 77L
BaseConfiguration.swift MLXLMCommon pinned 169L 169L 169L
Chat.swift MLXLMCommon pinned 150L 150L 150L
ChatSession.swift MLXLMCommon pinned 359L 371L 371L
GenerationConfigFile.swift MLXLMCommon pinned 16L 16L 16L
InterpolationUtils.swift MLXLMCommon pinned 454L 454L 454L
JSONDecodingTypes.swift MLXLMCommon pinned 148L 148L 148L
LanguageModel.swift MLXLMCommon pinned 219L 219L 232L
ModelConfiguration.swift MLXLMCommon pinned 102L 109L 109L
ModelContainer.swift MLXLMCommon pinned 207L 210L 210L
ModelFactory.swift MLXLMCommon pinned 388L 388L 388L
Module+Extensions.swift MLXLMCommon pinned 24L 24L 24L
RoPEUtils.swift MLXLMCommon pinned 276L 276L 276L
SuScaledRoPE.swift MLXLMCommon pinned 75L 75L 75L
UserInput.swift MLXLMCommon pinned 345L 365L 365L
WiredMemoryPolicies.swift MLXLMCommon latest — 182L 182L
WiredMemoryUtils.swift MLXLMCommon latest — 249L 249L
Tool.swift MLXLMCommon/Tool pinned 63L 63L 63L
ToolCall.swift MLXLMCommon/Tool pinned 57L 57L 57L
ToolCallProcessor.swift MLXLMCommon/Tool pinned 136L 200L 200L
ToolParameter.swift MLXLMCommon/Tool pinned 85L 85L 85L
Value.swift MLXLMCommon/Tool pinned 131L 131L 131L
Generated by Scripts/gen-patch-comparison.sh — 2026-03-02 14:11:45
maclocal-api 038ba82 · ml-explore/mlx-swift-lm · ml-explore/mlx-swift