Tesseract OCR es un motor de reconocimiento óptico de caracteres de código abierto, mantenido bajo licencia Apache. Transforma el contenido de una imagen o un escaneo en texto utilizable. Antes de usarlo en un script de Python o en la línea de comandos, primero debe instalarse correctamente en su máquina, y es a menudo ahí donde comienzan los problemas.
Variable PATH y error de comando: la trampa que bloquea la mayoría de las instalaciones
Ha lanzado el instalador, hecho clic en “Siguiente” varias veces, y luego escribió tesseract en su terminal. Resultado: “no se reconoce como un comando interno o externo”. Este mensaje es el problema más común después de una instalación manual de Tesseract en Windows.
La causa es simple. El instalador gráfico clásico (el que ofrece UB Mannheim) no siempre modifica la variable de entorno PATH de su sistema. El PATH es la lista de carpetas en las que Windows busca los programas cuando escribe su nombre en un terminal.
Si la carpeta de instalación de Tesseract (por defecto C:Program FilesTesseract-OCR) no está en esa lista, su sistema simplemente no sabe dónde encontrar el ejecutable. Hay dos formas de evitar esta trampa, y la primera merece ser conocida porque resuelve el problema antes de que aparezca.
Los gestores de paquetes como winget o Chocolatey permiten descargar e instalar Tesseract OCR con un solo comando, con configuración automática del PATH. Por ejemplo, winget install -e --id UB-Mannheim.TesseractOCR o choco install tesseract instalan el motor y añaden la ruta del sistema sin intervención manual.
Instalar Tesseract OCR en Windows sin gestor de paquetes
Si prefiere la instalación gráfica, dirígete al repositorio de GitHub de UB Mannheim para obtener el instalador .exe (disponible en 64 y 32 bits). El proceso es similar al de cualquier software de Windows: aceptar la licencia, elegir la carpeta de destino, seleccionar los componentes.
Agregar la ruta al PATH manualmente
Después de la instalación, abra la configuración del sistema (escriba “variables de entorno” en la barra de búsqueda de Windows). En la sección “Variables del sistema”, seleccione la variable Path, luego haga clic en “Modificar” y añada la ruta de la carpeta Tesseract.
Verifique la instalación abriendo una nueva terminal (no la que ya estaba abierta antes de la modificación). Escriba tesseract --version. Si se muestra el número de versión, todo funciona.
Seleccionar los paquetes de idiomas durante la instalación
Por defecto, solo se incluye el paquete en inglés. Para reconocer texto en francés, marque el componente correspondiente en el instalador, o añádalo después descargando el archivo fra.traineddata en la carpeta tessdata de su instalación.
Tesseract OCR en macOS y Linux: comandos de instalación
La instalación en macOS y Linux se realiza directamente a través de los gestores de paquetes nativos, lo que simplifica considerablemente el procedimiento.
- En macOS, Homebrew gestiona la instalación completa: el comando
brew install tesseractdescarga el motor y las dependencias, y luego hace que el comando sea accesible en el terminal sin configuración adicional. - En Ubuntu y Debian,
sudo apt install tesseract-ocrinstala el motor. Para añadir el francés, solo hay que instalar el paquetetesseract-ocr-frapor separado. - En otras distribuciones de Linux, los comandos varían (yum, dnf, pacman), pero el principio sigue siendo el mismo: un paquete para el motor, un paquete por idioma.
En ambos casos, el PATH se configura automáticamente por el gestor de paquetes. No se necesita manipulación manual.
Compatibilidad de los archivos tessdata con Tesseract 5.x
Este es un punto que pocos guías abordan, y que provoca errores silenciosos. Tesseract 5.x utiliza un motor de reconocimiento basado en redes LSTM. Los archivos de datos de entrenamiento (los archivos .traineddata) existen en varias variantes, y no todas funcionan con todas las versiones del motor.
Tres repositorios oficiales de GitHub ofrecen archivos tessdata:
tessdata: archivos combinados, compatibles con el modo LSTM y el modo legado (más antiguos). Estos son los más versátiles.tessdata_best: modelos LSTM más precisos, pero más lentos. Adecuados cuando la calidad del reconocimiento es más importante que la velocidad.tessdata_fast: modelos LSTM optimizados para la rapidez, con una ligera pérdida de precisión.
Si utiliza Tesseract 5.x y descarga un archivo .traineddata desde el repositorio incorrecto, el motor puede producir resultados degradados o negarse a funcionar en modo legado. Antes de copiar un archivo en su carpeta tessdata, verifique su procedencia.
Primer test OCR en línea de comandos
Una vez que Tesseract esté instalado y el PATH configurado, realice una prueba rápida para confirmar que todo funciona. Prepare una imagen que contenga texto legible (un escaneo de documento o una captura de pantalla son adecuados).
Escriba en su terminal: tesseract image.png output -l fra. Este comando lee el archivo image.png, aplica el paquete de idioma francés y escribe el resultado en output.txt.
La calidad de la imagen de entrada determina la precisión del resultado. Un escaneo de baja resolución, un texto inclinado o un fondo muy contrastado reducen la fiabilidad del reconocimiento. Tesseract funciona mejor en imágenes nítidas, con texto horizontal y un contraste claro entre caracteres y fondo.
Para proyectos más avanzados (integración en código Python, procesamiento por lotes, segmentación de página), Tesseract también se utiliza como biblioteca a través de wrappers como pytesseract. La instalación del motor sigue siendo un requisito previo, independientemente del uso previsto después.
Mantenga su versión de Tesseract y sus archivos tessdata sincronizados: es la combinación de estos dos elementos la que garantiza un reconocimiento fiable a largo plazo.
