Installer Tesseract OCR
en quelques minutes.
Un guide d'installation complet et testé pour Windows, macOS, Linux, WSL2, Docker et Conda — avec configuration du PATH, données de langue, vérification et solutions aux erreurs les plus fréquentes.
Installation rapide (une commande)
Copiez la commande de votre plateforme. Les langues et le PATH sont détaillés plus bas.
Windows
Gestionnaires de paquets ou installateur UB Mannheim.
> winget install UB-Mannheim.TesseractOCR
macOS
Homebrew est la méthode recommandée.
$ brew install tesseract
Ubuntu / Debian
Disponible dans les dépôts officiels.
$ sudo apt install tesseract-ocr
Quelle méthode d'installation choisir ?
Choisissez la ligne correspondant à votre environnement. Le reste du guide détaille chaque méthode.
| Méthode | Recommandée pour | Langues | Droits admin |
|---|---|---|---|
| Installateur UB Mannheim (Windows) | La plupart des utilisateurs Windows | Choisies à l'installation | Oui (système) |
| winget / scoop / choco | Installations Windows par script ou utilisateur | À ajouter séparément | scoop : non |
| Homebrew / MacPorts (macOS) | Développement sur macOS | tesseract-lang | Non |
| apt / dnf / pacman / apk | Serveurs et postes Linux | Paquets par langue | Oui (sudo) |
| WSL2 | Utilisateurs Windows qui entraînent aussi des modèles | Paquets apt | Non |
| Docker | Services reproductibles et CI | Inclus dans l'image | Non |
| Conda | Environnements de data science | conda-forge | Non |
Installer sous Windows
Tesseract ne se compile pas facilement sous Windows. Utilisez l'installateur communautaire ou un gestionnaire de paquets, puis ajoutez-le au PATH.
Option A — Installateur UB Mannheim (recommandé)
Le projet UB Mannheim publie les builds standards de Tesseract 5.x pour Windows, en 64 et 32 bits. L'installateur inclut les outils d'entraînement et permet de choisir des langues.
- Téléchargez le fichier
tesseract-ocr-w64-setup-5.x.exele plus récent depuis la page UB Mannheim. - Lancez l'installateur et cochez les langues nécessaires (ou toutes).
- Installez dans le chemin par défaut
C:\Program Files\Tesseract-OCR. - Ajoutez ce dossier au PATH (ci-dessous) et redémarrez le terminal.
Option B — gestionnaires de paquets
> winget search tesseract
> winget install UB-Mannheim.TesseractOCR
> scoop install tesseract
> choco install tesseract
Les identifiants de paquets changent avec le temps : exécutez winget search tesseract ou scoop search tesseract si une commande échoue.
Ajouter Tesseract au PATH (l'étape que tout le monde oublie)
Si vous avez utilisé l'installateur UB Mannheim, tesseract ne sera pas trouvé tant que le dossier n'est pas dans le PATH.
- Ouvrez le menu Démarrer, recherchez Variables d'environnement et choisissez Modifier les variables d'environnement système.
- Cliquez sur Variables d'environnement… puis, dans Variables système, sélectionnez Path et cliquez sur Modifier.
- Cliquez sur Nouveau et ajoutez
C:\Program Files\Tesseract-OCR. - Validez et redémarrez complètement le terminal (et l'IDE).
> tesseract --version
Installer sous macOS
Homebrew est la méthode recommandée, sur Apple Silicon comme sur Intel.
$ brew install tesseract
$ brew install tesseract-lang # toutes les langues
Homebrew installe les binaires dans /opt/homebrew/bin (Apple Silicon) ou /usr/local/bin (Intel). Les données de langue sont dans le dossier tessdata ; trouvez-le avec brew info tesseract.
Alternative avec MacPorts
$ sudo port install tesseract
$ sudo port install tesseract-code # ex. tesseract-fra
Installer sous Linux
Toutes les grandes distributions fournissent Tesseract dans leurs dépôts officiels.
Debian / Ubuntu / Mint
$ sudo apt update
$ sudo apt install tesseract-ocr libtesseract-dev
$ sudo apt install tesseract-ocr-all # optionnel : toutes les langues
Si apt ne trouve pas le paquet, activez le dépôt universe. libtesseract-dev n'est nécessaire que pour compiler contre l'API.
Fedora / RHEL
$ sudo dnf install tesseract tesseract-devel tesseract-langpack-eng
Arch / Manjaro
$ sudo pacman -S tesseract tesseract-data-eng
Alpine
$ apk add tesseract-ocr tesseract-ocr-dev tesseract-ocr-data-eng
Besoin d'une version plus récente ? Compilez depuis les sources en suivant le guide officiel de compilation.
Installer sous Windows avec WSL2
WSL2 fournit un environnement Linux complet dans Windows — la voie la plus simple si vous voulez aussi entraîner des modèles.
> wsl --install -d Ubuntu
$ sudo apt update && sudo apt install tesseract-ocr tesseract-ocr-all libtesseract-dev
Installer avec Docker
Pour des services reproductibles et la CI, intégrez Tesseract dans une image avec version et langues figées.
Créez un Dockerfile :
FROM ubuntu:24.04
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
tesseract-ocr tesseract-ocr-eng tesseract-ocr-fra libtesseract-dev \
&& rm -rf /var/lib/apt/lists/*
ENTRYPOINT ["tesseract"]$ docker build -t tesseract .
$ docker run --rm -v "$PWD:/data" tesseract /data/image.png /data/out
Montez un volume pour que Tesseract lise l'image et écrive out.txt sur l'hôte. Ajoutez d'autres paquets tesseract-ocr-<langue> au Dockerfile.
Installer avec Conda
Idéal pour les environnements de data science où vous ne pouvez pas utiliser le gestionnaire système.
$ conda install -c conda-forge tesseract
Installer les données de langue (tessdata)
Le moteur inclut l'anglais par défaut. Ajoutez d'autres langues sous forme de paquets ou de fichiers .traineddata.
Installer les paquets de langue
$ sudo apt install tesseract-ocr-fra tesseract-ocr-deu # Debian/Ubuntu
$ brew install tesseract-lang # macOS (toutes)
$ sudo dnf install tesseract-langpack-fra # Fedora
Installer un fichier .traineddata manuellement
- Téléchargez le fichier de langue depuis les dépôts officiels : tessdata_fast (vitesse), tessdata_best (précision) ou tessdata (hérité).
- Copiez le fichier
.traineddatadans votre dossiertessdata(par ex.C:\Program Files\Tesseract-OCR\tessdata,/usr/share/tesseract-ocr/5/tessdataou$(brew --prefix)/share/tessdata). - Si les données sont ailleurs, indiquez-le avec la variable
TESSDATA_PREFIX. - Listez les langues disponibles pour confirmer :
tesseract --list-langs.
| Dépôt | Compromis | À utiliser quand |
|---|---|---|
tessdata_fast | Le plus petit et le plus rapide, un peu moins précis | Pipelines temps réel ou à fort volume |
tessdata_best | Précision maximale, plus lent et plus lourd | Archivage ou précision critique |
tessdata | Hérité + LSTM, compatible --oem 0 | Anciens modèles ou compatibilité héritée |
Vérifier l'installation
Effectuez ces trois vérifications avant de continuer. Si l'une échoue, consultez le tableau de dépannage.
$ tesseract --version
$ tesseract --list-langs
$ tesseract exemple.png stdout -l eng
Une exécution réussie affiche la version, liste eng (et les langues installées) et renvoie le texte reconnu de votre image.
Mettre à jour, gérer et désinstaller
Gardez le moteur à jour ou supprimez-le proprement.
| Tâche | Windows | macOS | Linux |
|---|---|---|---|
| Mettre à jour | winget upgrade / relancer l'installateur | brew upgrade tesseract | sudo apt upgrade tesseract-ocr |
| Désinstaller | winget uninstall UB-Mannheim.TesseractOCR | brew uninstall tesseract | sudo apt remove tesseract-ocr |
| Versions multiples | N'en garder qu'une dans le PATH | Ne pas mélanger brew et MacPorts | Utiliser un PPA ou compiler |
Dépannage
Ces cas couvrent la grande majorité des problèmes d'installation.
| Symptôme | Cause | Solution |
|---|---|---|
tesseract: command not found | Dossier d'installation absent du PATH | Ajoutez C:\Program Files\Tesseract-OCR (Windows) ou le bin de brew (macOS) au PATH et redémarrez le terminal. |
Error opening data file .../eng.traineddata | Données de langue manquantes ou mauvais chemin | Installez le paquet de langue ou définissez TESSDATA_PREFIX sur le dossier contenant eng.traineddata. |
TesseractNotFoundError (Python) | pytesseract ne trouve pas le binaire | Définissez pytesseract.pytesseract.tesseract_cmd sur le chemin complet ou corrigez le PATH. |
| Mauvaise version | Plusieurs installations dans le PATH | Réordonnez le PATH ou supprimez le doublon ; which -a tesseract / where tesseract. |
| Permission refusée | Installation système sans privilèges | Utilisez sudo sous Linux ou scoop/Conda pour une installation utilisateur. |
| Docker ne trouve pas l'image | Volume non monté | Montez le dossier avec -v "$PWD:/data" et utilisez /data/... dans le conteneur. |
FAQ installation
Comment installer Tesseract OCR sous Windows ?
Téléchargez l'installateur UB Mannheim pour Tesseract 5.x, exécutez-le, ajoutez C:\Program Files\Tesseract-OCR au PATH et vérifiez avec tesseract --version. Vous pouvez aussi utiliser winget, scoop ou chocolatey.
Comment installer Tesseract OCR sous Ubuntu ?
Exécutez sudo apt update && sudo apt install tesseract-ocr libtesseract-dev. Activez le dépôt universe si nécessaire, et installez tesseract-ocr-all pour toutes les langues.
Où Tesseract est-il installé ?
Windows : C:\Program Files\Tesseract-OCR. macOS avec Homebrew : /opt/homebrew (Apple Silicon) ou /usr/local (Intel). Linux : généralement /usr/bin/tesseract, données dans /usr/share/tesseract-ocr/.
Dois-je installer quelque chose pour Python ?
Oui. Le wrapper pytesseract appelle le binaire Tesseract : installez d'abord le moteur, puis pip install pytesseract pillow. La documentation montre un exemple minimal.
Puis-je installer Tesseract sans droits administrateur ?
Oui. Utilisez scoop ou une version portable sous Windows, ou conda install -c conda-forge tesseract sur tout système.
Tesseract est-il gratuit pour un usage commercial ?
Oui. Tesseract est distribué sous licence Apache 2.0 et gratuit pour un usage personnel, académique et commercial.
Étapes suivantes
Une fois le moteur installé, apprenez à l'utiliser.