Instalar o Tesseract OCR
em minutos.
Guia de instalação completo e testado para Windows, macOS, Linux, WSL2, Docker e Conda, com configuração do PATH, dados de idioma, verificação e soluções para os erros mais comuns.
Instalação rápida (um comando)
Copie o comando da sua plataforma. Os idiomas e o PATH são detalhados abaixo.
Windows
Gerenciadores de pacotes ou o instalador da UB Mannheim.
> winget install UB-Mannheim.TesseractOCR
macOS
O Homebrew é o método recomendado.
$ brew install tesseract
Ubuntu / Debian
Disponível nos repositórios oficiais.
$ sudo apt install tesseract-ocr
Qual método de instalação devo usar?
Escolha a linha que corresponde ao seu ambiente. O restante do guia detalha cada método.
| Método | Recomendado para | Idiomas | Permissões de admin |
|---|---|---|---|
| Instalador UB Mannheim (Windows) | Maioria dos usuários do Windows | Escolhidos na instalação | Sim (todo o sistema) |
| winget / scoop / choco | Instalações de Windows por script ou de usuário | Adicionados à parte | scoop: não |
| Homebrew / MacPorts (macOS) | Desenvolvimento no macOS | tesseract-lang | Não |
| apt / dnf / pacman / apk | Servidores e desktops Linux | Pacotes por idioma | Sim (sudo) |
| WSL2 | Usuários do Windows que também treinam modelos | Pacotes apt | Não |
| Docker | Serviços reproduzíveis e CI | Incluídos na imagem | Não |
| Conda | Ambientes de ciência de dados | conda-forge | Não |
Instalar no Windows
O Tesseract não é compilado facilmente no Windows. Use o instalador da comunidade ou um gerenciador de pacotes e adicione-o ao PATH.
Opção A — Instalador da UB Mannheim (recomendado)
O projeto UB Mannheim publica as compilações padrão do Tesseract 5.x para Windows, em 64 e 32 bits. O instalador inclui as ferramentas de treinamento e permite escolher idiomas durante a instalação.
- Baixe o arquivo mais recente
tesseract-ocr-w64-setup-5.x.exena página da UB Mannheim. - Execute o instalador e marque os idiomas necessários (ou todos).
- Instale no caminho padrão,
C:\Program Files\Tesseract-OCR. - Adicione essa pasta ao PATH (abaixo) e reinicie o terminal.
Opção B — gerenciadores de pacotes
> winget search tesseract
> winget install UB-Mannheim.TesseractOCR
> scoop install tesseract
> choco install tesseract
Os IDs de pacote mudam com o tempo: execute winget search tesseract ou scoop search tesseract se um comando não funcionar.
Adicionar o Tesseract ao PATH (o passo que todos esquecem)
Se você instalou pela UB Mannheim, tesseract não será encontrado até que a pasta esteja no PATH.
- Abra o menu Iniciar, pesquise Variáveis de Ambiente e escolha Editar as variáveis de ambiente do sistema.
- Clique em Variáveis de Ambiente… e, em Variáveis do sistema, selecione Path e clique em Editar.
- Clique em Novo e adicione
C:\Program Files\Tesseract-OCR. - Confirme tudo e reinicie completamente o terminal (e a IDE) para aplicar o novo PATH.
> tesseract --version
Instalar no macOS
O Homebrew é o método recomendado, tanto em Apple Silicon quanto em Intel.
$ brew install tesseract
$ brew install tesseract-lang # todos os idiomas
O Homebrew instala os binários em /opt/homebrew/bin (Apple Silicon) ou /usr/local/bin (Intel). Os dados de idioma ficam no diretório tessdata; localize-o com brew info tesseract.
Alternativa com MacPorts
$ sudo port install tesseract
$ sudo port install tesseract-codigo # ex.: tesseract-fra
Instalar no Linux
Todas as principais distribuições trazem o Tesseract nos repositórios oficiais.
Debian / Ubuntu / Mint
$ sudo apt update
$ sudo apt install tesseract-ocr libtesseract-dev
$ sudo apt install tesseract-ocr-all # opcional: todos os idiomas
Se o apt não encontrar o pacote, habilite o repositório universe. O libtesseract-dev só é necessário ao compilar contra a 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
Precisa de uma versão mais recente? Compile do código-fonte seguindo o guia oficial de compilação.
Instalar no Windows com WSL2
O WSL2 oferece um ambiente Linux completo dentro do Windows — o caminho mais fácil se você também quer treinar modelos.
> wsl --install -d Ubuntu
$ sudo apt update && sudo apt install tesseract-ocr tesseract-ocr-all libtesseract-dev
Instalar com Docker
Para serviços reproduzíveis e CI, inclua o Tesseract em uma imagem com versão e idiomas fixos.
Crie um Dockerfile:
FROM ubuntu:24.04
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
tesseract-ocr tesseract-ocr-eng tesseract-ocr-por 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
Monte um volume para o Tesseract ler a imagem e gravar out.txt no host. Adicione mais pacotes tesseract-ocr-<idioma> ao Dockerfile para mais idiomas.
Instalar com Conda
Ideal para ambientes de ciência de dados onde você não pode usar o gerenciador do sistema.
$ conda install -c conda-forge tesseract
Instalar dados de idioma (tessdata)
O motor inclui inglês por padrão. Adicione mais idiomas como pacotes ou como arquivos .traineddata.
Instalar pacotes 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 um arquivo .traineddata manualmente
- Baixe o arquivo do idioma nos repositórios oficiais: tessdata_fast (velocidade), tessdata_best (precisão) ou tessdata (legado).
- Copie o arquivo
.traineddatapara o diretóriotessdata(por exemploC:\Program Files\Tesseract-OCR\tessdata,/usr/share/tesseract-ocr/5/tessdataou$(brew --prefix)/share/tessdata). - Se os dados estiverem em outro caminho, indique-o com a variável
TESSDATA_PREFIX. - Liste os idiomas disponíveis para confirmar:
tesseract --list-langs.
| Repositório | Compromisso | Use quando |
|---|---|---|
tessdata_fast | Menor e mais rápido, um pouco menos preciso | Pipelines em tempo real ou de alto volume |
tessdata_best | Máxima precisão, mais lento e pesado | Arquivamento ou precisão crítica |
tessdata | Legado + LSTM, compatível com --oem 0 | Modelos antigos ou compatibilidade legada |
Verificar a instalação
Execute estas três verificações antes de continuar. Se alguma falhar, consulte a tabela de problemas.
$ tesseract --version
$ tesseract --list-langs
$ tesseract amostra.png stdout -l eng
Uma execução correta mostra a versão, lista eng (e os idiomas instalados) e devolve o texto reconhecido da sua imagem.
Atualizar, gerenciar e desinstalar
Mantenha o motor atualizado ou remova-o por completo.
| Tarefa | Windows | macOS | Linux |
|---|---|---|---|
| Atualizar | 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 |
| Várias versões | Deixe apenas uma no PATH | Não misture brew e MacPorts | Use um PPA ou compile do código |
Solução de problemas
Estas falhas cobrem a grande maioria dos problemas de instalação.
| Sintoma | Causa | Solução |
|---|---|---|
tesseract: command not found | O diretório de instalação não está no PATH | Adicione C:\Program Files\Tesseract-OCR (Windows) ou o bin do brew (macOS) ao PATH e reinicie o terminal. |
Error opening data file .../eng.traineddata | Dados de idioma ausentes ou caminho errado | Instale o pacote do idioma ou defina TESSDATA_PREFIX para a pasta que contém eng.traineddata. |
TesseractNotFoundError (Python) | O pytesseract não encontra o binário | Defina pytesseract.pytesseract.tesseract_cmd com o caminho completo ou corrija o PATH. |
| Versão incorreta | Há mais de uma instalação no PATH | Reordene o PATH ou remova a duplicada; use which -a tesseract / where tesseract. |
| Permissão negada | Instalação no sistema sem privilégios | Use sudo no Linux ou scoop/Conda para uma instalação de usuário. |
| Docker não encontra a imagem | Volume não montado | Monte a pasta com -v "$PWD:/data" e use /data/... dentro do contêiner. |
Perguntas frequentes de instalação
Como instalo o Tesseract OCR no Windows?
Baixe o instalador da UB Mannheim para o Tesseract 5.x, execute-o, adicione C:\Program Files\Tesseract-OCR ao PATH e verifique com tesseract --version. Você também pode usar winget, scoop ou chocolatey.
Como instalo o Tesseract OCR no Ubuntu?
Execute sudo apt update && sudo apt install tesseract-ocr libtesseract-dev. Habilite o repositório universe se o pacote não for encontrado, e instale tesseract-ocr-all para todos os idiomas.
Onde o Tesseract é instalado?
Windows: C:\Program Files\Tesseract-OCR. macOS com Homebrew: /opt/homebrew (Apple Silicon) ou /usr/local (Intel). Linux: normalmente /usr/bin/tesseract, com os dados em /usr/share/tesseract-ocr/.
Preciso instalar algo para Python?
Sim. O wrapper pytesseract chama o binário do Tesseract, então instale primeiro o motor e depois pip install pytesseract pillow. A documentação mostra um exemplo mínimo.
Posso instalar o Tesseract sem privilégios de administrador?
Sim. Use scoop ou uma versão portátil no Windows, ou conda install -c conda-forge tesseract em qualquer sistema.
O Tesseract é gratuito para uso comercial?
Sim. O Tesseract é distribuído sob a licença Apache 2.0 e é gratuito para uso pessoal, acadêmico e comercial.
Próximos passos
Com o motor instalado, aprenda a usá-lo.