メインコンテンツへスキップ
開発者ガイド

Tesseract OCR をインストール
数分で完了。

Windows・macOS・Linux・WSL2・Docker・Conda 向けの、検証済みで完全なインストールガイドです。PATH の設定、言語データ、動作確認、よくあるエラーの解決方法まで網羅しています。

クイックインストール(1 コマンド)

お使いのプラットフォームのコマンドをコピーしてください。言語と PATH は以下で詳しく説明します。

Windows

パッケージマネージャー、または UB Mannheim インストーラー。

powershell

> winget install UB-Mannheim.TesseractOCR

macOS

Homebrew が推奨される方法です。

zsh

$ brew install tesseract

Ubuntu / Debian

公式リポジトリで提供されています。

bash

$ sudo apt install tesseract-ocr

どのインストール方法を選ぶべきか

環境に合う行を選んでください。以降で各方法を詳しく説明します。

方法向いている用途言語データ管理者権限
UB Mannheim インストーラー(Windows)ほとんどの Windows ユーザーインストール時に選択必要(システム全体)
winget / scoop / chocoスクリプトまたはユーザー単位の Windows 導入別途追加scoop: 不要
Homebrew / MacPorts(macOS)macOS での開発tesseract-lang不要
apt / dnf / pacman / apkLinux のサーバー・デスクトップ言語ごとのパッケージ必要(sudo)
WSL2モデル学習も行う Windows ユーザーapt パッケージ不要
Docker再現性のあるサービスと CIイメージに同梱不要
Condaデータサイエンス環境conda-forge不要

Windows にインストール

Tesseract は Windows では簡単にはコンパイルできません。コミュニティのインストーラーかパッケージマネージャーを使い、PATH に追加します。

方法 A — UB Mannheim インストーラー(推奨)

UB Mannheim プロジェクトが Tesseract 5.x の Windows 向け標準ビルド(64/32 ビット)を公開しています。インストーラーには学習ツールが含まれ、言語も選択できます。

  1. UB Mannheim のページから最新の tesseract-ocr-w64-setup-5.x.exe をダウンロードします。
  2. インストーラーを実行し、必要な言語(またはすべて)を選択します。
  3. 既定の場所 C:\Program Files\Tesseract-OCR にインストールします。
  4. そのフォルダーを PATH に追加し(下記)、ターミナルを再起動します。

方法 B — パッケージマネージャー

powershell

> winget search tesseract

> winget install UB-Mannheim.TesseractOCR

> scoop install tesseract

> choco install tesseract

パッケージ ID は変わることがあります。コマンドが失敗する場合は winget search tesseract や scoop search tesseract を実行してください。

Tesseract を PATH に追加する(見落としやすい手順)

UB Mannheim のインストーラーで導入した場合、フォルダーが PATH に入るまで tesseract は見つかりません。

  1. スタートメニューで 環境変数 を検索し、システム環境変数の編集 を選びます。
  2. 環境変数… をクリックし、システム環境変数 の Path を選んで 編集 をクリックします。
  3. 新規 をクリックし、C:\Program Files\Tesseract-OCR を追加します。
  4. すべて確定し、ターミナル(および IDE)を完全に再起動します。
確認

> tesseract --version

macOS にインストール

Apple Silicon・Intel のどちらでも Homebrew が推奨されます。

zsh

$ brew install tesseract

$ brew install tesseract-lang # すべての言語

Homebrew はバイナリを /opt/homebrew/bin(Apple Silicon)または /usr/local/bin(Intel)に配置します。言語データは tessdata ディレクトリにあり、brew info tesseract で確認できます。

MacPorts を使う場合

zsh

$ sudo port install tesseract

$ sudo port install tesseract-言語コード # 例: tesseract-fra

Linux にインストール

主要なディストリビューションはすべて公式リポジトリで Tesseract を提供しています。

Debian / Ubuntu / Mint

bash

$ sudo apt update

$ sudo apt install tesseract-ocr libtesseract-dev

$ sudo apt install tesseract-ocr-all # 任意: すべての言語

apt で見つからない場合は universe リポジトリを有効にしてください。libtesseract-dev は API に対してコンパイルする場合のみ必要です。

Fedora / RHEL

bash

$ sudo dnf install tesseract tesseract-devel tesseract-langpack-eng

Arch / Manjaro

bash

$ sudo pacman -S tesseract tesseract-data-eng

Alpine

sh

$ apk add tesseract-ocr tesseract-ocr-dev tesseract-ocr-data-eng

より新しいバージョンが必要な場合は、公式のコンパイルガイドに従ってソースからビルドしてください。

Windows で WSL2 を使う

WSL2 は Windows 内に完全な Linux 環境を提供します。モデル学習も行いたい場合に最も簡単な方法です。

powershell → ubuntu

> wsl --install -d Ubuntu

$ sudo apt update && sudo apt install tesseract-ocr tesseract-ocr-all libtesseract-dev

Docker でインストール

再現性のあるサービスや CI には、バージョンと言語を固定したイメージに Tesseract を組み込みます。

Dockerfile を作成します。

Dockerfile
FROM ubuntu:24.04
RUN apt-get update \
 && apt-get install -y --no-install-recommends \
      tesseract-ocr tesseract-ocr-eng tesseract-ocr-jpn libtesseract-dev \
 && rm -rf /var/lib/apt/lists/*
ENTRYPOINT ["tesseract"]
bash

$ docker build -t tesseract .

$ docker run --rm -v "$PWD:/data" tesseract /data/image.png /data/out

ボリュームをマウントすると、Tesseract が画像を読み取り、out.txt をホストに書き出します。言語を増やすには Dockerfile に tesseract-ocr-<言語> パッケージを追加します。

Conda でインストール

システムのパッケージマネージャーを使えないデータサイエンス環境に最適です。

bash

$ conda install -c conda-forge tesseract

言語データ(tessdata)のインストール

エンジンには英語が同梱されています。言語はパッケージまたは .traineddata ファイルとして追加します。

言語パッケージをインストール

bash

$ sudo apt install tesseract-ocr-fra tesseract-ocr-deu # Debian/Ubuntu

$ brew install tesseract-lang # macOS(すべて)

$ sudo dnf install tesseract-langpack-fra # Fedora

.traineddata ファイルを手動でインストール

  1. 公式リポジトリから言語ファイルをダウンロードします: tessdata_fast(速度重視)、tessdata_best(精度重視)、tessdata(レガシー)。
  2. .traineddata ファイルを tessdata ディレクトリ(例: C:\Program Files\Tesseract-OCR\tessdata、/usr/share/tesseract-ocr/5/tessdata、$(brew --prefix)/share/tessdata)にコピーします。
  3. データが別の場所にある場合は、環境変数 TESSDATA_PREFIX で指定します。
  4. tesseract --list-langs で利用可能な言語を確認します。
リポジトリトレードオフ使う場面
tessdata_fast最小・最速だが精度はやや低いリアルタイムまたは大量処理のパイプライン
tessdata_best最高精度だが低速・大容量アーカイブや精度重視の作業
tessdataレガシー + LSTM、--oem 0 に対応旧モデルやレガシー互換が必要な場合

動作確認

先に進む前にこの 3 つを実行してください。失敗した場合は下のトラブルシューティングを参照してください。

確認

$ tesseract --version

$ tesseract --list-langs

$ tesseract sample.png stdout -l eng

成功すると、バージョンが表示され、eng(および導入済みの言語)が一覧表示され、画像から認識したテキストが出力されます。

更新・管理・アンインストール

エンジンを最新に保つ、またはきれいに削除します。

操作WindowsmacOSLinux
更新winget upgrade / インストーラー再実行brew upgrade tesseractsudo apt upgrade tesseract-ocr
アンインストールwinget uninstall UB-Mannheim.TesseractOCRbrew uninstall tesseractsudo apt remove tesseract-ocr
複数バージョンPATH には 1 つだけ残すbrew と MacPorts を混在させないPPA を使うかソースからビルド

トラブルシューティング

以下のケースでインストール時の問題のほとんどをカバーできます。

症状原因解決策
tesseract: command not foundインストール先が PATH にないC:\Program Files\Tesseract-OCR(Windows)または brew の bin(macOS)を PATH に追加し、ターミナルを再起動します。
Error opening data file .../eng.traineddata言語データの欠落またはパス誤り言語パッケージを導入するか、eng.traineddata を含むフォルダーを TESSDATA_PREFIX に設定します。
TesseractNotFoundError(Python)pytesseract がバイナリを見つけられないpytesseract.pytesseract.tesseract_cmd にフルパスを設定するか、PATH を修正します。
バージョンが違うPATH 上に複数のインストールがあるPATH を並べ替えるか重複を削除します。which -a tesseract / where tesseract。
アクセス拒否権限のないシステムインストールLinux では sudo、または scoop/Conda でユーザー単位に導入します。
Docker が画像を見つけられないボリューム未マウント-v "$PWD:/data" でフォルダーをマウントし、コンテナ内では /data/... を参照します。

インストール FAQ

Windows に Tesseract OCR をインストールするには?

Tesseract 5.x 用の UB Mannheim インストーラーをダウンロードして実行し、C:\Program Files\Tesseract-OCR を PATH に追加して tesseract --version で確認します。winget、scoop、chocolatey も利用できます。

Ubuntu に Tesseract OCR をインストールするには?

sudo apt update && sudo apt install tesseract-ocr libtesseract-dev を実行します。必要に応じて universe リポジトリを有効にし、全言語は tesseract-ocr-all で導入します。

Tesseract はどこにインストールされますか?

Windows: C:\Program Files\Tesseract-OCR。macOS の Homebrew: /opt/homebrew(Apple Silicon)または /usr/local(Intel)。Linux: 通常 /usr/bin/tesseract、データは /usr/share/tesseract-ocr/。

Python 用に何かインストールが必要ですか?

はい。ラッパー pytesseract は Tesseract のバイナリを呼び出すため、まずエンジンを導入し、その後 pip install pytesseract pillow を実行します。ドキュメントに最小例があります。

管理者権限なしでインストールできますか?

はい。Windows では scoop またはポータブル版、どの環境でも conda install -c conda-forge tesseract を利用できます。

Tesseract は商用利用でも無料ですか?

はい。Tesseract は Apache 2.0 ライセンスで配布されており、個人・学術・商用いずれも無料です。

エンジンを導入したら、使い方を学びましょう。