Tesseract OCR ist eine Open-Source-OCR-Engine, die unter der Apache-Lizenz gepflegt wird. Sie wandelt den Inhalt eines Bildes oder Scans in nutzbaren Text um. Bevor Sie es in einem Python-Skript oder über die Befehlszeile verwenden, müssen Sie es zunächst korrekt auf Ihrem Rechner installieren, und genau hier beginnen oft die Probleme.
PATH-Variable und Befehlsfehler: die Falle, die die meisten Installationen blockiert
Sie haben den Installer gestartet, mehrmals auf “Weiter” geklickt und dann tesseract in Ihr Terminal eingegeben. Ergebnis: “wird nicht als interner oder externer Befehl erkannt”. Diese Meldung ist das häufigste Problem nach einer manuellen Installation von Tesseract unter Windows.
Die Ursache ist einfach. Der klassische grafische Installer (der von UB Mannheim angeboten wird) ändert nicht immer die PATH-Umgebungsvariable Ihres Systems. Der PATH ist die Liste der Ordner, in denen Windows nach Programmen sucht, wenn Sie deren Namen in ein Terminal eingeben.
Wenn der Installationsordner von Tesseract (standardmäßig C:Program FilesTesseract-OCR) nicht darin enthalten ist, weiß Ihr System einfach nicht, wo es die ausführbare Datei finden kann. Es gibt zwei Möglichkeiten, diese Falle zu vermeiden, und die erste sollte bekannt sein, da sie das Problem löst, bevor es überhaupt auftritt.
Paketmanager wie winget oder Chocolatey ermöglichen es, Tesseract OCR mit einem einzigen Befehl herunterzuladen und zu installieren, mit automatischer PATH-Konfiguration. Zum Beispiel installieren winget install -e --id UB-Mannheim.TesseractOCR oder choco install tesseract die Engine und fügen den Systempfad ohne manuelles Eingreifen hinzu.
Tesseract OCR unter Windows ohne Paketmanager installieren
Wenn Sie die grafische Installation bevorzugen, besuchen Sie das GitHub-Repository von UB Mannheim, um den .exe-Installer herunterzuladen (verfügbar in 64 und 32 Bit). Der Prozess ähnelt dem von jeder anderen Windows-Software: Lizenz akzeptieren, Zielordner auswählen, Komponenten auswählen.
Pfad manuell zum PATH hinzufügen
Nach der Installation öffnen Sie die Systemeinstellungen (geben Sie “Umgebungsvariablen” in die Windows-Suchleiste ein). Wählen Sie im Abschnitt “Systemvariablen” die Variable Path, klicken Sie auf “Bearbeiten” und fügen Sie den Pfad zum Tesseract-Ordner hinzu.
Überprüfen Sie die Installation, indem Sie ein neues Terminal öffnen (nicht das, das bereits vor der Änderung geöffnet war). Geben Sie tesseract --version ein. Wenn die Versionsnummer angezeigt wird, funktioniert alles.
Sprachpakete während der Installation auswählen
Standardmäßig ist nur das englische Paket enthalten. Um französischen Text zu erkennen, aktivieren Sie die entsprechende Komponente im Installer oder fügen Sie sie nachträglich hinzu, indem Sie die Datei fra.traineddata in den tessdata-Ordner Ihrer Installation herunterladen.
Tesseract OCR auf macOS und Linux: Installationsbefehle
Die Installation auf macOS und Linux erfolgt direkt über die nativen Paketmanager, was den Prozess erheblich vereinfacht.
- Auf macOS verwaltet Homebrew die vollständige Installation: Der Befehl
brew install tesseractlädt die Engine und die Abhängigkeiten herunter und macht den Befehl im Terminal ohne zusätzliche Konfiguration zugänglich. - Auf Ubuntu und Debian installiert
sudo apt install tesseract-ocrdie Engine. Um Französisch hinzuzufügen, muss das Pakettesseract-ocr-fraseparat installiert werden. - Auf anderen Linux-Distributionen variieren die Befehle (yum, dnf, pacman), aber das Prinzip bleibt dasselbe: ein Paket für die Engine, ein Paket pro Sprache.
In beiden Fällen wird der PATH automatisch vom Paketmanager konfiguriert. Keine manuelle Manipulation erforderlich.
Kompatibilität der tessdata-Dateien mit Tesseract 5.x
Dies ist ein Punkt, den nur wenige Anleitungen ansprechen und der stille Fehler verursacht. Tesseract 5.x verwendet eine Erkennungsengine, die auf LSTM-Netzen basiert. Die Trainingsdatendateien (die .traineddata-Dateien) existieren in mehreren Varianten, und nicht alle funktionieren mit allen Versionen der Engine.
Drei offizielle GitHub-Repositories bieten tessdata-Dateien an:
tessdata: kombinierte Dateien, die mit dem LSTM-Modus und dem Legacy-Modus (älter) kompatibel sind. Dies sind die vielseitigsten.tessdata_best: die genauesten LSTM-Modelle, aber langsamer. Geeignet, wenn die Erkennungsqualität über der Geschwindigkeit steht.tessdata_fast: LSTM-Modelle, die auf Geschwindigkeit optimiert sind, mit einem leichten Verlust an Genauigkeit.
Wenn Sie Tesseract 5.x verwenden und eine .traineddata-Datei aus dem falschen Repository herunterladen, kann die Engine degradierte Ergebnisse liefern oder im Legacy-Modus nicht funktionieren. Überprüfen Sie die Herkunft einer Datei, bevor Sie sie in Ihren tessdata-Ordner kopieren.
Erster OCR-Test über die Befehlszeile
Sobald Tesseract installiert und der PATH konfiguriert ist, führen Sie einen schnellen Test durch, um zu bestätigen, dass alles funktioniert. Bereiten Sie ein Bild mit lesbarem Text vor (ein Scan eines Dokuments oder ein Screenshot sind geeignet).
Geben Sie in Ihrem Terminal ein: tesseract image.png output -l fra. Dieser Befehl liest die Datei image.png, wendet das französische Sprachpaket an und schreibt das Ergebnis in output.txt.
Die Qualität des Eingabebildes bestimmt die Genauigkeit des Ergebnisses. Ein Scan in niedriger Auflösung, geneigter Text oder ein stark kontrastierender Hintergrund verringern die Zuverlässigkeit der Erkennung. Tesseract funktioniert am besten mit scharfen Bildern, mit horizontalem Text und einem deutlichen Kontrast zwischen Zeichen und Hintergrund.
Für fortgeschrittenere Projekte (Integration in Python-Code, Batch-Verarbeitung, Seiten-Segmentierung) kann Tesseract auch als Bibliothek über Wrapper wie pytesseract verwendet werden. Die Installation der Engine bleibt die Voraussetzung, unabhängig von der späteren Verwendung.
Halten Sie Ihre Tesseract-Version und Ihre tessdata-Dateien synchronisiert: Es ist die Kombination dieser beiden Elemente, die eine zuverlässige Erkennung auf lange Sicht gewährleistet.
