pip install git+https://github.com/will702/mlx-vision.git
# with PDF support:
pip install "mlx-vision[pdf] @ git+https://github.com/will702/mlx-vision.git"

Quick start

python

from mlx_vision import ocr

result = ocr("document.png", model="deepseek-ocr-2", mode="auto")
print(result.text)

bash

mlx-vision -m deepseek-ocr-2 -i page.png --mode dspark -v
mlx-vision -m deepseek-ocr-2 -i doc.pdf --page 0 --dpi 200

Modes

baseline — mlx-vlm generate
dspark / lookup — training-free semi-AR draft + confidence schedule (OCR DSpark weights not public yet)
dflash / eagle3 / mtp — neural speculation via mlx-vlm (--drafter)
auto — best available path

Cite

See CITATION.cff. Related paper: DSpark.

License

MIT