# macMLX v0.5.3 (historical)

A retrospective summary of what shipped on 2026-07-08, using current audited definitions while preserving the tagged v0.5.3 record as authority.

## Direct answer

This page is a retrospective summary of capabilities that shipped in v0.5.3 on 2026-07-08, expressed using the site's current audited fact definitions. Those definitions may evolve and are not a frozen snapshot of that date. GitHub's v0.5.3 release and tagged changelog remain the authoritative historical record for what the release contained and the boundaries documented at the tag.

- Canonical: https://macmlx.app/releases/v0-5-3/
- Last verified: 2026-07-15

## Page facts

- **OpenAI endpoint compatibility** — Released; since 0.5.3; last verified 2026-07-15. Chat, legacy completions, model listing, and embeddings use compatible request and response shapes. Compatibility is endpoint-specific. macMLX model load and unload routes under /x/models are project extensions, not OpenAI-compatible model management.
- **Anthropic Messages compatibility** — Released; since 0.5.3; last verified 2026-07-15. POST /v1/messages, including streaming, is available in v0.5.3. This is Messages API compatibility only, not compatibility with the full Anthropic API.
- **Selected Ollama endpoints** — Released; since 0.3.7; last verified 2026-07-15. macMLX supports /api/version, /api/tags, /api/show, /api/chat, and /api/generate. The compatibility layer has shipped since v0.3.7. It is a selected endpoint set, not a drop-in replacement for every Ollama API.
- **MCP server** — Released; since 0.5.0; last verified 2026-07-15. The CLI can expose local inference to MCP clients. The MCP server shipped in v0.5.0 and is separate from chat-side routing to external tools.
- **MCP client pool** — Released; since 0.5.3; last verified 2026-07-15. v0.5.3 includes managed MCP client connections. The pool manages external MCP processes and connections; integrated chat-side tool routing is a separate capability released in v0.6.0.
- **Local embeddings** — Released; since 0.5.3; last verified 2026-07-15. POST /v1/embeddings shipped in v0.5.3. Encoder-family model detection exists, while using an unsuitable chat model can still produce vectors without semantic guarantees.
- **Bi-encoder rerank MVP** — Released; since 0.5.3; last verified 2026-07-15. POST /v1/rerank scores independently embedded texts with cosine similarity. This released MVP is not a cross-encoder reranker.
- **Exact-prefix RAM and SSD cache** — Released; since 0.5.0; last verified 2026-07-15. A hot RAM tier and content-addressed SSD cold tier support promotion and demotion. The released v0.5.0 cache reuses exact full prefixes. It does not provide released block sharing or paged KV allocation.
- **Bounded model pool** — Released; since 0.5.0; last verified 2026-07-15. Budgets, LRU eviction, pinning, cold swap, idle TTL, and probes bound multi-model use. The pool shipped in v0.5.0 and was hardened in v0.5.3. It is not a unified adaptive controller.
- **Supported LoRA adapters** — Released; since 0.5.0; last verified 2026-07-15. The native engine can apply supported LoRA adapters. Adapter compatibility depends on the base architecture and weights; universal LoRA compatibility is not claimed.
- **Fourteen detected VLM families** — Released; since 0.5.3; last verified 2026-07-15. The model library detects 14 vision-language model_type families. This is an evidence-backed family count, not a guarantee that every checkpoint or processor variant will load.
- **DeepSeek V3.2 Swift overlay** — Released; since 0.5.3; last verified 2026-07-15. v0.5.3 includes pure-Swift component parity for the DeepSeek V3.2 architecture. A real-checkpoint smoke test remains pending and FP8 dequantization is absent, so this is not an end-to-end or universal MoE claim.
- **Paged KV, block sharing, and CoW** — Planned; since future; last verified 2026-07-15. Paged allocation, shared blocks, and copy-on-write branching are planned. None of these cache-virtualization features is released in v0.6.2.
- **Unified adaptive memory guard** — Planned; since future; last verified 2026-07-15. A feedback controller across cache, model pool, and concurrency is planned. Released memory probes and pool caps are separate mechanisms and must not be described as this guard.
- **Expanded sampling controls** — Planned; since future; last verified 2026-07-15. top-k, min-p, presence, frequency, and repetition penalties, plus per-request seed are planned. DeepSeek expert-routing top-k is an internal architecture operation and is unrelated to user sampling top-k.

## Sources

- https://github.com/magicnight/mac-mlx/releases/tag/v0.6.2
- https://github.com/magicnight/mac-mlx/blob/v0.6.2/CHANGELOG.md
- https://github.com/magicnight/mac-mlx/blob/v0.6.2/MacMLXCore/Sources/MacMLXCore/Server/HummingbirdServer.swift
- https://github.com/magicnight/mac-mlx/blob/v0.6.2/MacMLXCore/Sources/MacMLXCore/MCP/MCPClientPool.swift
- https://github.com/magicnight/mac-mlx/blob/v0.6.2/MacMLXCore/Sources/MacMLXCore/Engine/EmbeddingEngine.swift
- https://github.com/magicnight/mac-mlx/blob/v0.6.2/MacMLXCore/Sources/MacMLXCore/Engine/RerankScoring.swift
- https://github.com/magicnight/mac-mlx/blob/v0.6.2/MacMLXCore/Sources/MacMLXCore/PromptCache/PromptCacheStore.swift
- https://github.com/magicnight/mac-mlx/blob/v0.6.2/MacMLXCore/Sources/MacMLXCore/ModelPool/ModelPool.swift
- https://github.com/magicnight/mac-mlx/blob/v0.6.2/MacMLXCore/Sources/MacMLXCore/Managers/ModelLibraryManager.swift
- https://github.com/magicnight/mac-mlx/blob/v0.6.2/MacMLXCore/Sources/MacMLXCore/Models/DeepseekV32.swift
- https://github.com/magicnight/mac-mlx/blob/main/docs/superpowers/specs/2026-07-10-engine-scroll-story-design.md
- https://github.com/magicnight/mac-mlx/blob/main/MacMLXCore/Sources/MacMLXCore/Managers/ModelParametersStore.swift
- https://github.com/magicnight/mac-mlx/releases/tag/v0.5.3
- https://github.com/magicnight/mac-mlx/blob/v0.5.3/CHANGELOG.md

## Related pages

- [Release status without roadmap blur](https://macmlx.app/releases/)
- [Local API compatibility, endpoint by endpoint](https://macmlx.app/api-compatibility/)
- [Vision-language model support](https://macmlx.app/models/vision-language-models/)
