Installation

Installer Docling sur macOS

Apple Silicon (M1/M2/M3/M4) et Macs Intel avec Python 3.10+. Vérifiez chaque commande contre la documentation officielle d'installation.

Step 1

Quel Mac avez-vous ?

uname -m

arm64 → Apple Silicon. Suivez les sections 2–6. Accélération MPS disponible.
x86_64 → Intel. Suivez les sections 2–3, puis la section 7 avant d'installer des extras — les wheels torch récents n'existent pas pour Intel.

Step 2

Setup Python (les deux puces)

python3 --version

python3 -m venv .venv && source .venv/bin/activate

python -m pip install -U pip

Installez Python 3.10–3.12 depuis python.org ou via brew install python@3.12.
Macs Intel : restez sur Python ≤3.12 — PyTorch 2.2.2 (dernier build compatible Intel) l'exige.
Utilisez toujours un venv :

Step 3

Installation de base

Alternative uv : uv add docling (ou uv pip install docling dans le venv).

pip install docling

Step 4

Apple Silicon + accélération MPS

Apple Silicon fait tourner Docling sur le backend MPS (Metal) de PyTorch plutôt que CUDA. CPU est le défaut et fonctionne bien ; sélectionnez MPS pour la vitesse GPU. Si cela affiche False, mettez à jour macOS + torch ; certains moteurs OCR restent CPU-only de toute façon.

docling convert report.pdf --device mps

docling convert report.pdf --device auto

python -c "import torch; print(torch.backends.mps.is_available())"

Step 5

OcrMac : OCR natif Apple Vision

Extra macOS-only utilisant le framework Apple Vision intégré — aucun binaire Tesseract requis, OCR privé sur l'appareil. Pour les scans anglais/européens sur macOS moderne. Pour le CJK ou les écritures complexes, comparez avec RapidOCR/EasyOCR dans le guide OCR.

pip install "docling[ocrmac]"

docling convert scan.pdf --ocr-engine ocrmac --ocr-mode full_page

Step 6

Tesseract via Homebrew

Nécessaire uniquement pour les moteurs Tesseract (tesserocr, CLI). Installez le binaire d'abord. TESSDATA_PREFIX doit finir par un slash et pointer vers le dossier des fichiers .traineddata. Sur Homebrew Intel, c'est généralement /usr/local/share/tessdata/. Persistez avec export TESSDATA_PREFIX=… dans votre profil de shell.

brew install tesseract leptonica pkg-config

pip install "docling[tesserocr]"

TESSDATA_PREFIX=/opt/homebrew/share/tessdata/ docling convert scan.pdf --ocr-engine tesseract

Step 7

Macs Intel : le pin torch

Pourquoi : PyTorch 2.6.0+ ne publie plus de wheels pour macOS Intel, donc un simple pip install docling peut échouer sur torch. Deux contournements supportés (Python ≤3.12 requis). Si un torch cassé est déjà installé, supprimez-le (pip uninstall torch torchvision) et réinstallez avec une ligne ci-dessus.

uv add torch==2.2.2 torchvision==0.17.2 docling

pip install "docling[mac_intel]"

Step 8

Vérification

Confirmez ensuite l'accélérateur et l'OCR séparément : --device mps sur Apple Silicon, --ocr-engine ocrmac ou rapidocr sur une page scannée.

docling --help

docling convert sample.pdf --to md

Step 9

Problèmes macOS fréquents

torch échoue sur Intel — appliquez le pin de la section 7 ; pas de Python 3.13+ sur Intel.
TesseractNotFound / langues manquantes — réinstallez via Homebrew, définissez TESSDATA_PREFIX (slash final), voir erreur d'installation du paquet OCR.
Erreur d'import OcrMac — l'extra ne fonctionne que sur macOS récent ; réinstallez "docling[ocrmac]" dans le venv.
MPS inutilisé — vérifiez torch.backends.mps.is_available() ; certaines étapes retombent sur CPU par conception.
Erreurs SSL / certificats au premier téléchargement — mettez à jour les certificats Python (Install Certificates.command de l'installeur python.org) et relancez.

Step 10

FAQ macOS

M-series ou Intel — est-ce que ça compte ?

Oui pour deux choses : Apple Silicon peut utiliser --device mps et l'extra OcrMac ; les Macs Intel doivent épingler torch 2.2.2 et rester sur Python ≤3.12. Tout le reste est identique.

OcrMac ou Tesseract ?

OcrMac est zéro-configuration et privé (Vision sur l'appareil). Tesseract offre plus de contrôle langues/écritures mais exige Homebrew + TESSDATA_PREFIX. RapidOCR est un bon entre-deux pip-only.

Faut-il Xcode ?

Non. Seuls les outils en ligne de commande Xcode sont parfois requis si pip compile quelque chose : xcode-select --install.

python ou python3 ?

Dans le venv, les deux pointent vers le même interpréteur. En dehors, macOS réserve python — utilisez toujours python3 -m venv et activez avant d'installer.

Vérifié avec Docling v2.129.0 · Dernière vérification 2026-09-22 · Source officielle