File	Upstream (old shim)	This repo
`config.json` `model_type`	`deepseekocr`	`unlimited-ocr`
`processor_config.json` `processor_class`	`DeepseekOCRProcessor`	`UnlimitedOCRHFProcessor`
`processor_config.json` `sft_format`	`deepseek`	`unlimitedocr`
Weights	MXFP8	unchanged

On mlx-vlm 0.6+, the upstream deepseekocr shim often generates repetitive garbage. Routing to unlimited-ocr restores correct OCR.

Usage

bash

pip install -U "mlx-vlm>=0.6.0" pymupdf
# PDF helper + CLI: https://github.com/will702/unlimited-ocr-mlx

python

from mlx_vlm import load, generate
from mlx_vlm.prompt_utils import apply_chat_template
from mlx_vlm.utils import load_config

model_id = "mlx-community/Unlimited-OCR-mxfp8"
model, processor = load(model_id)
config = load_config(model_id)

prompt = apply_chat_template(processor, config, "Free OCR.", num_images=1)
out = generate(
    model, processor,
    prompt=prompt,
    image="page.png",
    max_tokens=4096,
    temperature=0.0,
    repetition_penalty=1.05,
)
text = out.text.replace("Ġ", " ").replace("Ċ", "\n")
print(text)

Prefer prompt Free OCR. — document parsing. often stops immediately on this MLX path.

Credits

Base model: baidu/Unlimited-OCR (MIT)
MXFP8 quantization: sahilchachra/unlimited-ocr-mxfp8-mlx
Runtime: mlx-vlm
Config fix + Mac tooling: will702/unlimited-ocr-mlx
Published as: mlx-community/Unlimited-OCR-mxfp8