Installare Tesseract OCR
in pochi minuti.
Una guida di installazione completa e testata per Windows, macOS, Linux, WSL2, Docker e Conda, con configurazione del PATH, dati lingua, verifica e soluzioni agli errori più comuni.
Installazione rapida (un comando)
Copia il comando per la tua piattaforma. Lingue e PATH sono descritti più sotto.
Windows
Gestori di pacchetti o l'installer UB Mannheim.
> winget install UB-Mannheim.TesseractOCR
macOS
Homebrew è il metodo consigliato.
$ brew install tesseract
Ubuntu / Debian
Disponibile nei repository ufficiali.
$ sudo apt install tesseract-ocr
Quale metodo di installazione usare?
Scegli la riga corrispondente al tuo ambiente. Il resto della guida descrive ogni metodo in dettaglio.
| Metodo | Consigliato per | Lingue | Diritti admin |
|---|---|---|---|
| Installer UB Mannheim (Windows) | La maggior parte degli utenti Windows | Scelte in fase di installazione | Sì (sistema) |
| winget / scoop / choco | Installazioni Windows da script o utente | Da aggiungere a parte | scoop: no |
| Homebrew / MacPorts (macOS) | Sviluppo su macOS | tesseract-lang | No |
| apt / dnf / pacman / apk | Server e desktop Linux | Pacchetti per lingua | Sì (sudo) |
| WSL2 | Utenti Windows che addestrano anche modelli | Pacchetti apt | No |
| Docker | Servizi riproducibili e CI | Inclusi nell'immagine | No |
| Conda | Ambienti di data science | conda-forge | No |
Installare su Windows
Tesseract non si compila facilmente su Windows. Usa l'installer della community o un gestore di pacchetti, poi aggiungilo al PATH.
Opzione A — Installer UB Mannheim (consigliato)
Il progetto UB Mannheim pubblica le build standard di Tesseract 5.x per Windows, a 64 e 32 bit. L'installer include gli strumenti di addestramento e permette di scegliere le lingue.
- Scarica il file
tesseract-ocr-w64-setup-5.x.exepiù recente dalla pagina UB Mannheim. - Esegui l'installer e seleziona le lingue necessarie (o tutte).
- Installa nel percorso predefinito
C:\Program Files\Tesseract-OCR. - Aggiungi quella cartella al PATH (sotto) e riavvia il terminale.
Opzione B — gestori di pacchetti
> winget search tesseract
> winget install UB-Mannheim.TesseractOCR
> scoop install tesseract
> choco install tesseract
Gli ID dei pacchetti cambiano nel tempo: esegui winget search tesseract o scoop search tesseract se un comando non funziona.
Aggiungere Tesseract al PATH (il passaggio che tutti dimenticano)
Se hai usato l'installer UB Mannheim, tesseract non verrà trovato finché la cartella non è nel PATH.
- Apri il menu Start, cerca Variabili d'ambiente e scegli Modifica le variabili d'ambiente di sistema.
- Fai clic su Variabili d'ambiente… e, in Variabili di sistema, seleziona Path e fai clic su Modifica.
- Fai clic su Nuovo e aggiungi
C:\Program Files\Tesseract-OCR. - Conferma tutto e riavvia completamente il terminale (e l'IDE).
> tesseract --version
Installare su macOS
Homebrew è il metodo consigliato, sia su Apple Silicon sia su Intel.
$ brew install tesseract
$ brew install tesseract-lang # tutte le lingue
Homebrew installa i binari in /opt/homebrew/bin (Apple Silicon) o /usr/local/bin (Intel). I dati lingua sono nella cartella tessdata; trovala con brew info tesseract.
Alternativa con MacPorts
$ sudo port install tesseract
$ sudo port install tesseract-codice # es. tesseract-fra
Installare su Linux
Tutte le principali distribuzioni includono Tesseract nei repository ufficiali.
Debian / Ubuntu / Mint
$ sudo apt update
$ sudo apt install tesseract-ocr libtesseract-dev
$ sudo apt install tesseract-ocr-all # opzionale: tutte le lingue
Se apt non trova il pacchetto, abilita il repository universe. libtesseract-dev serve solo per compilare contro 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
Serve una versione più recente? Compila dai sorgenti seguendo la guida ufficiale di compilazione.
Installare su Windows con WSL2
WSL2 offre un ambiente Linux completo dentro Windows: la via più semplice se vuoi anche addestrare modelli.
> wsl --install -d Ubuntu
$ sudo apt update && sudo apt install tesseract-ocr tesseract-ocr-all libtesseract-dev
Installare con Docker
Per servizi riproducibili e CI, includi Tesseract in un'immagine con versione e lingue fisse.
Crea un Dockerfile:
FROM ubuntu:24.04
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
tesseract-ocr tesseract-ocr-eng tesseract-ocr-ita 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
Monta un volume per far leggere l'immagine a Tesseract e scrivere out.txt sull'host. Aggiungi altri pacchetti tesseract-ocr-<lingua> al Dockerfile.
Installare con Conda
Ideale per ambienti di data science in cui non puoi usare il gestore di sistema.
$ conda install -c conda-forge tesseract
Installare i dati lingua (tessdata)
Il motore include l'inglese per impostazione predefinita. Aggiungi altre lingue come pacchetti o file .traineddata.
Installare i pacchetti lingua
$ sudo apt install tesseract-ocr-fra tesseract-ocr-deu # Debian/Ubuntu
$ brew install tesseract-lang # macOS (tutte)
$ sudo dnf install tesseract-langpack-fra # Fedora
Installare un file .traineddata manualmente
- Scarica il file della lingua dai repository ufficiali: tessdata_fast (velocità), tessdata_best (precisione) o tessdata (legacy).
- Copia il file
.traineddatanella cartellatessdata(ad es.C:\Program Files\Tesseract-OCR\tessdata,/usr/share/tesseract-ocr/5/tessdatao$(brew --prefix)/share/tessdata). - Se i dati sono altrove, indicalo con la variabile
TESSDATA_PREFIX. - Elenca le lingue disponibili per confermare:
tesseract --list-langs.
| Repository | Compromesso | Usalo quando |
|---|---|---|
tessdata_fast | Il più piccolo e veloce, leggermente meno preciso | Pipeline in tempo reale o ad alto volume |
tessdata_best | Massima precisione, più lento e pesante | Archiviazione o precisione critica |
tessdata | Legacy + LSTM, compatibile con --oem 0 | Modelli vecchi o compatibilità legacy |
Verificare l'installazione
Esegui questi tre controlli prima di procedere. Se uno fallisce, consulta la tabella di risoluzione.
$ tesseract --version
$ tesseract --list-langs
$ tesseract esempio.png stdout -l eng
Un'esecuzione corretta mostra la versione, elenca eng (e le lingue installate) e restituisce il testo riconosciuto dalla tua immagine.
Aggiornare, gestire e disinstallare
Mantieni il motore aggiornato o rimuovilo in modo pulito.
| Attività | Windows | macOS | Linux |
|---|---|---|---|
| Aggiornare | winget upgrade / rieseguire l'installer | brew upgrade tesseract | sudo apt upgrade tesseract-ocr |
| Disinstallare | winget uninstall UB-Mannheim.TesseractOCR | brew uninstall tesseract | sudo apt remove tesseract-ocr |
| Versioni multiple | Mantieni solo una nel PATH | Non mischiare brew e MacPorts | Usa un PPA o compila dai sorgenti |
Risoluzione dei problemi
Questi casi coprono la grande maggioranza dei problemi di installazione.
| Sintomo | Causa | Soluzione |
|---|---|---|
tesseract: command not found | Cartella di installazione non nel PATH | Aggiungi C:\Program Files\Tesseract-OCR (Windows) o il bin di brew (macOS) al PATH e riavvia il terminale. |
Error opening data file .../eng.traineddata | Dati lingua mancanti o percorso errato | Installa il pacchetto della lingua o imposta TESSDATA_PREFIX sulla cartella che contiene eng.traineddata. |
TesseractNotFoundError (Python) | pytesseract non trova il binario | Imposta pytesseract.pytesseract.tesseract_cmd sul percorso completo o correggi il PATH. |
| Versione errata | Più di un'installazione nel PATH | Riordina il PATH o rimuovi il duplicato; which -a tesseract / where tesseract. |
| Permesso negato | Installazione di sistema senza privilegi | Usa sudo su Linux o scoop/Conda per un'installazione utente. |
| Docker non trova l'immagine | Volume non montato | Monta la cartella con -v "$PWD:/data" e usa /data/... nel container. |
FAQ sull'installazione
Come installo Tesseract OCR su Windows?
Scarica l'installer UB Mannheim per Tesseract 5.x, eseguilo, aggiungi C:\Program Files\Tesseract-OCR al PATH e verifica con tesseract --version. Puoi anche usare winget, scoop o chocolatey.
Come installo Tesseract OCR su Ubuntu?
Esegui sudo apt update && sudo apt install tesseract-ocr libtesseract-dev. Abilita il repository universe se necessario e installa tesseract-ocr-all per tutte le lingue.
Dove viene installato Tesseract?
Windows: C:\Program Files\Tesseract-OCR. macOS con Homebrew: /opt/homebrew (Apple Silicon) o /usr/local (Intel). Linux: di solito /usr/bin/tesseract, dati in /usr/share/tesseract-ocr/.
Devo installare qualcosa per Python?
Sì. Il wrapper pytesseract chiama il binario di Tesseract: installa prima il motore, poi pip install pytesseract pillow. La documentazione mostra un esempio minimo.
Posso installare Tesseract senza privilegi di amministratore?
Sì. Usa scoop o una versione portatile su Windows, oppure conda install -c conda-forge tesseract su qualsiasi sistema.
Tesseract è gratuito per uso commerciale?
Sì. Tesseract è distribuito con licenza Apache 2.0 ed è gratuito per uso personale, accademico e commerciale.
Passi successivi
Dopo l'installazione, scopri come usarlo.