Instalar Tesseract OCR
en minutos.
Guía de instalación completa y probada para Windows, macOS, Linux, WSL2, Docker y Conda, con configuración del PATH, datos de idioma, verificación y soluciones a los errores más habituales.
Instalación rápida (un comando)
Copia el comando de tu plataforma. Más abajo se detallan los idiomas y el PATH.
Windows
Gestores de paquetes o el instalador de UB Mannheim.
> winget install UB-Mannheim.TesseractOCR
macOS
Homebrew es el método recomendado.
$ brew install tesseract
Ubuntu / Debian
Disponible en los repositorios oficiales.
$ sudo apt install tesseract-ocr
¿Qué método de instalación debo usar?
Elige la fila que corresponda a tu entorno. El resto de la guía detalla cada método.
| Método | Recomendado para | Idiomas | Permisos de admin |
|---|---|---|---|
| Instalador UB Mannheim (Windows) | La mayoría de usuarios de Windows | Se eligen al instalar | Sí (todo el sistema) |
| winget / scoop / choco | Instalaciones de Windows por script o de usuario | Se añaden aparte | scoop: no |
| Homebrew / MacPorts (macOS) | Desarrollo en macOS | tesseract-lang | No |
| apt / dnf / pacman / apk | Servidores y escritorios Linux | Paquetes por idioma | Sí (sudo) |
| WSL2 | Usuarios de Windows que también entrenan modelos | Paquetes apt | No |
| Docker | Servicios reproducibles y CI | Incluidos en la imagen | No |
| Conda | Entornos de ciencia de datos | conda-forge | No |
Instalar en Windows
Tesseract no se compila fácilmente en Windows. Usa el instalador de la comunidad o un gestor de paquetes y añádelo al PATH.
Opción A — Instalador de UB Mannheim (recomendado)
El proyecto UB Mannheim publica las compilaciones estándar de Tesseract 5.x para Windows, de 64 y 32 bits. El instalador incluye las herramientas de entrenamiento y permite elegir idiomas durante la instalación.
- Descarga el archivo más reciente
tesseract-ocr-w64-setup-5.x.exedesde la página de UB Mannheim. - Ejecuta el instalador y marca los idiomas que necesites (o todos).
- Instala en la ruta por defecto,
C:\Program Files\Tesseract-OCR. - Añade esa carpeta al PATH (ver abajo) y reinicia la terminal.
Opción B — gestores de paquetes
> winget search tesseract
> winget install UB-Mannheim.TesseractOCR
> scoop install tesseract
> choco install tesseract
Los identificadores de paquete cambian con el tiempo: ejecuta winget search tesseract o scoop search tesseract si un comando no funciona.
Añadir Tesseract al PATH (el paso que todos olvidan)
Si instalaste con UB Mannheim, tesseract no se encontrará hasta que su carpeta esté en el PATH.
- Abre el menú Inicio, busca Variables de entorno y elige Editar las variables de entorno del sistema.
- Pulsa Variables de entorno… y, en Variables del sistema, selecciona Path y pulsa Editar.
- Pulsa Nuevo y añade
C:\Program Files\Tesseract-OCR. - Acepta y reinicia por completo la terminal (y el IDE) para que se aplique el nuevo PATH.
> tesseract --version
Instalar en macOS
Homebrew es el método recomendado, tanto en Apple Silicon como en Intel.
$ brew install tesseract
$ brew install tesseract-lang # todos los idiomas
Homebrew instala los binarios en /opt/homebrew/bin (Apple Silicon) o /usr/local/bin (Intel). Los datos de idioma están en el directorio tessdata; localízalo con brew info tesseract.
Alternativa con MacPorts
$ sudo port install tesseract
$ sudo port install tesseract-codigo # p. ej. tesseract-fra
Instalar en Linux
Todas las distribuciones importantes incluyen Tesseract en sus repositorios oficiales.
Debian / Ubuntu / Mint
$ sudo apt update
$ sudo apt install tesseract-ocr libtesseract-dev
$ sudo apt install tesseract-ocr-all # opcional: todos los idiomas
Si apt no encuentra el paquete, habilita el repositorio universe. libtesseract-dev solo es necesario si compilas contra la 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
¿Necesitas una versión más reciente? Compila desde el código fuente siguiendo la guía oficial de compilación.
Instalar en Windows con WSL2
WSL2 ofrece un entorno Linux completo dentro de Windows: la ruta más sencilla si además quieres entrenar modelos.
> wsl --install -d Ubuntu
$ sudo apt update && sudo apt install tesseract-ocr tesseract-ocr-all libtesseract-dev
Instalar con Docker
Para servicios reproducibles y CI, incluye Tesseract en una imagen con versión e idiomas fijados.
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-spa 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 volumen para que Tesseract lea tu imagen y escriba out.txt en el equipo. Añade más paquetes tesseract-ocr-<idioma> al Dockerfile para más idiomas.
Instalar con Conda
Ideal para entornos de ciencia de datos donde no puedes usar el gestor del sistema.
$ conda install -c conda-forge tesseract
Instalar datos de idioma (tessdata)
El motor incluye inglés por defecto. Añade más idiomas como paquetes o como archivos .traineddata.
Instalar paquetes de idioma
$ sudo apt install tesseract-ocr-fra tesseract-ocr-deu # Debian/Ubuntu
$ brew install tesseract-lang # macOS (todos)
$ sudo dnf install tesseract-langpack-fra # Fedora
Instalar un archivo .traineddata manualmente
- Descarga el archivo del idioma desde los repositorios oficiales: tessdata_fast (velocidad), tessdata_best (precisión) o tessdata (heredado).
- Copia el archivo
.traineddataen tu directoriotessdata(por ejemploC:\Program Files\Tesseract-OCR\tessdata,/usr/share/tesseract-ocr/5/tessdatao$(brew --prefix)/share/tessdata). - Si los datos están en otra ruta, indícala con la variable de entorno
TESSDATA_PREFIX. - Lista los idiomas disponibles para confirmar:
tesseract --list-langs.
| Repositorio | Compromiso | Úsalo cuando |
|---|---|---|
tessdata_fast | El más pequeño y rápido, algo menos preciso | Pipelines en tiempo real o de gran volumen |
tessdata_best | Máxima precisión, más lento y pesado | Trabajos de archivo o donde la precisión es crítica |
tessdata | Heredado + LSTM, compatible con --oem 0 | Modelos antiguos o compatibilidad heredada |
Verificar la instalación
Ejecuta estas tres comprobaciones antes de continuar. Si alguna falla, consulta la tabla de problemas.
$ tesseract --version
$ tesseract --list-langs
$ tesseract muestra.png stdout -l eng
Una ejecución correcta muestra la versión, lista eng (y los idiomas instalados) y devuelve el texto reconocido de tu imagen.
Actualizar, gestionar y desinstalar
Mantén el motor actualizado o elimínalo por completo.
| Tarea | Windows | macOS | Linux |
|---|---|---|---|
| Actualizar | winget upgrade / reinstalar | brew upgrade tesseract | sudo apt upgrade tesseract-ocr |
| Desinstalar | winget uninstall UB-Mannheim.TesseractOCR | brew uninstall tesseract | sudo apt remove tesseract-ocr |
| Varias versiones | Deja solo una en el PATH | No mezcles brew y MacPorts | Usa un PPA o compila desde el código |
Solución de problemas
Estos fallos cubren la gran mayoría de problemas de instalación.
| Síntoma | Causa | Solución |
|---|---|---|
tesseract: command not found | El directorio de instalación no está en el PATH | Añade C:\Program Files\Tesseract-OCR (Windows) o el bin de brew (macOS) al PATH y reinicia la terminal. |
Error opening data file .../eng.traineddata | Faltan datos de idioma o la ruta es incorrecta | Instala el paquete del idioma o define TESSDATA_PREFIX en la carpeta que contiene eng.traineddata. |
TesseractNotFoundError (Python) | pytesseract no encuentra el binario | Define pytesseract.pytesseract.tesseract_cmd con la ruta completa o corrige el PATH. |
| Versión incorrecta | Hay más de una instalación en el PATH | Reordena el PATH o elimina la duplicada; usa which -a tesseract / where tesseract. |
| Permiso denegado | Instalación en el sistema sin privilegios | Usa sudo en Linux o scoop/Conda para una instalación de usuario. |
| Docker no encuentra la imagen | Volumen no montado | Monta la carpeta con -v "$PWD:/data" y usa /data/... dentro del contenedor. |
Preguntas frecuentes de instalación
¿Cómo instalo Tesseract OCR en Windows?
Descarga el instalador de UB Mannheim para Tesseract 5.x, ejecútalo, añade C:\Program Files\Tesseract-OCR al PATH y verifica con tesseract --version. También puedes usar winget, scoop o chocolatey.
¿Cómo instalo Tesseract OCR en Ubuntu?
Ejecuta sudo apt update && sudo apt install tesseract-ocr libtesseract-dev. Habilita el repositorio universe si no se encuentra el paquete, e instala tesseract-ocr-all para todos los idiomas.
¿Dónde se instala Tesseract?
Windows: C:\Program Files\Tesseract-OCR. macOS con Homebrew: /opt/homebrew (Apple Silicon) o /usr/local (Intel). Linux: normalmente /usr/bin/tesseract, con los datos en /usr/share/tesseract-ocr/.
¿Necesito instalar algo para Python?
Sí. El wrapper pytesseract llama al binario de Tesseract, así que instala primero el motor y luego pip install pytesseract pillow. La documentación muestra un ejemplo mínimo.
¿Puedo instalar Tesseract sin permisos de administrador?
Sí. Usa scoop o una compilación portátil en Windows, o conda install -c conda-forge tesseract en cualquier sistema.
¿Tesseract es gratis para uso comercial?
Sí. Tesseract se distribuye bajo la licencia Apache 2.0 y es gratuito para uso personal, académico y comercial.
Siguientes pasos
Una vez instalado el motor, aprende a usarlo.