Tesseract OCR をインストール
数分で完了。
Windows・macOS・Linux・WSL2・Docker・Conda 向けの、検証済みで完全なインストールガイドです。PATH の設定、言語データ、動作確認、よくあるエラーの解決方法まで網羅しています。
クイックインストール(1 コマンド)
お使いのプラットフォームのコマンドをコピーしてください。言語と PATH は以下で詳しく説明します。
Windows
パッケージマネージャー、または UB Mannheim インストーラー。
> winget install UB-Mannheim.TesseractOCR
macOS
Homebrew が推奨される方法です。
$ brew install tesseract
Ubuntu / Debian
公式リポジトリで提供されています。
$ sudo apt install tesseract-ocr
どのインストール方法を選ぶべきか
環境に合う行を選んでください。以降で各方法を詳しく説明します。
| 方法 | 向いている用途 | 言語データ | 管理者権限 |
|---|---|---|---|
| UB Mannheim インストーラー(Windows) | ほとんどの Windows ユーザー | インストール時に選択 | 必要(システム全体) |
| winget / scoop / choco | スクリプトまたはユーザー単位の Windows 導入 | 別途追加 | scoop: 不要 |
| Homebrew / MacPorts(macOS) | macOS での開発 | tesseract-lang | 不要 |
| apt / dnf / pacman / apk | Linux のサーバー・デスクトップ | 言語ごとのパッケージ | 必要(sudo) |
| WSL2 | モデル学習も行う Windows ユーザー | apt パッケージ | 不要 |
| Docker | 再現性のあるサービスと CI | イメージに同梱 | 不要 |
| Conda | データサイエンス環境 | conda-forge | 不要 |
Windows にインストール
Tesseract は Windows では簡単にはコンパイルできません。コミュニティのインストーラーかパッケージマネージャーを使い、PATH に追加します。
方法 A — UB Mannheim インストーラー(推奨)
UB Mannheim プロジェクトが Tesseract 5.x の Windows 向け標準ビルド(64/32 ビット)を公開しています。インストーラーには学習ツールが含まれ、言語も選択できます。
- UB Mannheim のページから最新の
tesseract-ocr-w64-setup-5.x.exeをダウンロードします。 - インストーラーを実行し、必要な言語(またはすべて)を選択します。
- 既定の場所
C:\Program Files\Tesseract-OCRにインストールします。 - そのフォルダーを PATH に追加し(下記)、ターミナルを再起動します。
方法 B — パッケージマネージャー
> 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 は見つかりません。
- スタートメニューで 環境変数 を検索し、システム環境変数の編集 を選びます。
- 環境変数… をクリックし、システム環境変数 の Path を選んで 編集 をクリックします。
- 新規 をクリックし、
C:\Program Files\Tesseract-OCRを追加します。 - すべて確定し、ターミナル(および IDE)を完全に再起動します。
> tesseract --version
macOS にインストール
Apple Silicon・Intel のどちらでも Homebrew が推奨されます。
$ brew install tesseract
$ brew install tesseract-lang # すべての言語
Homebrew はバイナリを /opt/homebrew/bin(Apple Silicon)または /usr/local/bin(Intel)に配置します。言語データは tessdata ディレクトリにあり、brew info tesseract で確認できます。
MacPorts を使う場合
$ sudo port install tesseract
$ sudo port install tesseract-言語コード # 例: tesseract-fra
Linux にインストール
主要なディストリビューションはすべて公式リポジトリで Tesseract を提供しています。
Debian / Ubuntu / Mint
$ sudo apt update
$ sudo apt install tesseract-ocr libtesseract-dev
$ sudo apt install tesseract-ocr-all # 任意: すべての言語
apt で見つからない場合は universe リポジトリを有効にしてください。libtesseract-dev は 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
より新しいバージョンが必要な場合は、公式のコンパイルガイドに従ってソースからビルドしてください。
Windows で WSL2 を使う
WSL2 は Windows 内に完全な Linux 環境を提供します。モデル学習も行いたい場合に最も簡単な方法です。
> wsl --install -d Ubuntu
$ sudo apt update && sudo apt install tesseract-ocr tesseract-ocr-all libtesseract-dev
Docker でインストール
再現性のあるサービスや CI には、バージョンと言語を固定したイメージに Tesseract を組み込みます。
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"]$ docker build -t tesseract .
$ docker run --rm -v "$PWD:/data" tesseract /data/image.png /data/out
ボリュームをマウントすると、Tesseract が画像を読み取り、out.txt をホストに書き出します。言語を増やすには Dockerfile に tesseract-ocr-<言語> パッケージを追加します。
Conda でインストール
システムのパッケージマネージャーを使えないデータサイエンス環境に最適です。
$ conda install -c conda-forge tesseract
言語データ(tessdata)のインストール
エンジンには英語が同梱されています。言語はパッケージまたは .traineddata ファイルとして追加します。
言語パッケージをインストール
$ sudo apt install tesseract-ocr-fra tesseract-ocr-deu # Debian/Ubuntu
$ brew install tesseract-lang # macOS(すべて)
$ sudo dnf install tesseract-langpack-fra # Fedora
.traineddata ファイルを手動でインストール
- 公式リポジトリから言語ファイルをダウンロードします: tessdata_fast(速度重視)、tessdata_best(精度重視)、tessdata(レガシー)。
.traineddataファイルをtessdataディレクトリ(例:C:\Program Files\Tesseract-OCR\tessdata、/usr/share/tesseract-ocr/5/tessdata、$(brew --prefix)/share/tessdata)にコピーします。- データが別の場所にある場合は、環境変数
TESSDATA_PREFIXで指定します。 tesseract --list-langsで利用可能な言語を確認します。
| リポジトリ | トレードオフ | 使う場面 |
|---|---|---|
tessdata_fast | 最小・最速だが精度はやや低い | リアルタイムまたは大量処理のパイプライン |
tessdata_best | 最高精度だが低速・大容量 | アーカイブや精度重視の作業 |
tessdata | レガシー + LSTM、--oem 0 に対応 | 旧モデルやレガシー互換が必要な場合 |
動作確認
先に進む前にこの 3 つを実行してください。失敗した場合は下のトラブルシューティングを参照してください。
$ tesseract --version
$ tesseract --list-langs
$ tesseract sample.png stdout -l eng
成功すると、バージョンが表示され、eng(および導入済みの言語)が一覧表示され、画像から認識したテキストが出力されます。
更新・管理・アンインストール
エンジンを最新に保つ、またはきれいに削除します。
| 操作 | Windows | macOS | Linux |
|---|---|---|---|
| 更新 | winget upgrade / インストーラー再実行 | brew upgrade tesseract | sudo apt upgrade tesseract-ocr |
| アンインストール | winget uninstall UB-Mannheim.TesseractOCR | brew uninstall tesseract | sudo 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 ライセンスで配布されており、個人・学術・商用いずれも無料です。
次のステップ
エンジンを導入したら、使い方を学びましょう。