Instal Tesseract OCR
dalam hitungan menit.
Panduan instalasi lengkap dan teruji untuk Windows, macOS, Linux, WSL2, Docker, dan Conda — termasuk pengaturan PATH, data bahasa, verifikasi, dan solusi untuk kesalahan yang paling sering terjadi.
Instalasi cepat (satu perintah)
Salin perintah sesuai platform Anda. Bahasa dan PATH dijelaskan di bawah.
Windows
Manajer paket, atau installer UB Mannheim.
> winget install UB-Mannheim.TesseractOCR
macOS
Homebrew adalah metode yang direkomendasikan.
$ brew install tesseract
Ubuntu / Debian
Tersedia di repositori resmi.
$ sudo apt install tesseract-ocr
Metode instalasi mana yang harus dipilih?
Pilih baris yang sesuai lingkungan Anda. Bagian selanjutnya menjelaskan setiap metode.
| Metode | Cocok untuk | Data bahasa | Hak admin |
|---|---|---|---|
| Installer UB Mannheim (Windows) | Sebagian besar pengguna Windows | Dipilih saat instalasi | Ya (seluruh sistem) |
| winget / scoop / choco | Instalasi Windows via skrip atau pengguna | Ditambahkan terpisah | scoop: tidak |
| Homebrew / MacPorts (macOS) | Pengembangan di macOS | tesseract-lang | Tidak |
| apt / dnf / pacman / apk | Server dan desktop Linux | Paket per bahasa | Ya (sudo) |
| WSL2 | Pengguna Windows yang juga melatih model | Paket apt | Tidak |
| Docker | Layanan yang dapat direproduksi dan CI | Disertakan dalam image | Tidak |
| Conda | Lingkungan data science | conda-forge | Tidak |
Instal di Windows
Tesseract tidak mudah dikompilasi di Windows. Gunakan installer komunitas atau manajer paket, lalu tambahkan ke PATH.
Opsi A — Installer UB Mannheim (direkomendasikan)
Proyek UB Mannheim menerbitkan build standar Tesseract 5.x untuk Windows (64 dan 32 bit). Installer menyertakan alat pelatihan dan memungkinkan Anda memilih bahasa.
- Unduh berkas
tesseract-ocr-w64-setup-5.x.exeterbaru dari halaman UB Mannheim. - Jalankan installer dan centang bahasa yang dibutuhkan (atau semua).
- Instal di lokasi default
C:\Program Files\Tesseract-OCR. - Tambahkan folder tersebut ke PATH (di bawah) lalu mulai ulang terminal.
Opsi B — manajer paket
> winget search tesseract
> winget install UB-Mannheim.TesseractOCR
> scoop install tesseract
> choco install tesseract
ID paket dapat berubah seiring waktu: jalankan winget search tesseract atau scoop search tesseract bila perintah gagal.
Menambahkan Tesseract ke PATH (langkah yang sering terlewat)
Jika Anda memakai installer UB Mannheim, tesseract tidak akan ditemukan sampai folder tersebut ada di PATH.
- Buka menu Start, cari Environment Variables dan pilih Edit the system environment variables.
- Klik Environment Variables…, lalu di System variables pilih Path dan klik Edit.
- Klik New dan tambahkan
C:\Program Files\Tesseract-OCR. - Konfirmasi semuanya lalu mulai ulang terminal (dan IDE) sepenuhnya.
> tesseract --version
Instal di macOS
Homebrew adalah metode yang direkomendasikan, baik di Apple Silicon maupun Intel.
$ brew install tesseract
$ brew install tesseract-lang # semua bahasa
Homebrew memasang biner di /opt/homebrew/bin (Apple Silicon) atau /usr/local/bin (Intel). Data bahasa berada di direktori tessdata; temukan dengan brew info tesseract.
Alternatif dengan MacPorts
$ sudo port install tesseract
$ sudo port install tesseract-kode # mis. tesseract-fra
Instal di Linux
Semua distribusi utama menyediakan Tesseract di repositori resminya.
Debian / Ubuntu / Mint
$ sudo apt update
$ sudo apt install tesseract-ocr libtesseract-dev
$ sudo apt install tesseract-ocr-all # opsional: semua bahasa
Jika apt tidak menemukan paket, aktifkan repositori universe. libtesseract-dev hanya diperlukan untuk kompilasi terhadap 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
Butuh versi lebih baru? Kompilasi dari sumber dengan mengikuti panduan kompilasi resmi.
Instal di Windows dengan WSL2
WSL2 menyediakan lingkungan Linux lengkap di dalam Windows — cara termudah jika Anda juga ingin melatih model.
> wsl --install -d Ubuntu
$ sudo apt update && sudo apt install tesseract-ocr tesseract-ocr-all libtesseract-dev
Instal dengan Docker
Untuk layanan yang dapat direproduksi dan CI, sertakan Tesseract dalam image dengan versi dan bahasa yang tetap.
Buat Dockerfile:
FROM ubuntu:24.04
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
tesseract-ocr tesseract-ocr-eng tesseract-ocr-ind 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
Mount volume agar Tesseract dapat membaca gambar dan menulis out.txt ke host. Tambahkan paket tesseract-ocr-<bahasa> lain ke Dockerfile untuk bahasa tambahan.
Instal dengan Conda
Ideal untuk lingkungan data science yang tidak bisa memakai manajer paket sistem.
$ conda install -c conda-forge tesseract
Instal data bahasa (tessdata)
Mesin menyertakan bahasa Inggris secara default. Tambahkan bahasa lain sebagai paket atau berkas .traineddata.
Instal paket bahasa
$ sudo apt install tesseract-ocr-fra tesseract-ocr-deu # Debian/Ubuntu
$ brew install tesseract-lang # macOS (semua)
$ sudo dnf install tesseract-langpack-fra # Fedora
Instal berkas .traineddata secara manual
- Unduh berkas bahasa dari repositori resmi: tessdata_fast (kecepatan), tessdata_best (akurasi), atau tessdata (lama).
- Salin berkas
.traineddatake direktoritessdataAnda (mis.C:\Program Files\Tesseract-OCR\tessdata,/usr/share/tesseract-ocr/5/tessdata, atau$(brew --prefix)/share/tessdata). - Jika data berada di lokasi lain, arahkan dengan variabel
TESSDATA_PREFIX. - Daftar bahasa yang tersedia untuk memastikan:
tesseract --list-langs.
| Repositori | Trade-off | Gunakan saat |
|---|---|---|
tessdata_fast | Paling kecil dan cepat, akurasi sedikit lebih rendah | Pipeline real-time atau bervolume tinggi |
tessdata_best | Akurasi tertinggi, lebih lambat dan besar | Pengarsipan atau pekerjaan yang menuntut akurasi |
tessdata | Lama + LSTM, mendukung --oem 0 | Model lama atau kompatibilitas lama |
Verifikasi instalasi
Jalankan ketiga pemeriksaan ini sebelum melanjutkan. Jika ada yang gagal, lihat tabel pemecahan masalah.
$ tesseract --version
$ tesseract --list-langs
$ tesseract contoh.png stdout -l eng
Eksekusi yang berhasil menampilkan versi, mencantumkan eng (dan bahasa yang terpasang), serta mengeluarkan teks yang dikenali dari gambar Anda.
Perbarui, kelola, dan hapus
Jaga mesin tetap terbaru atau hapus dengan bersih.
| Tugas | Windows | macOS | Linux |
|---|---|---|---|
| Perbarui | winget upgrade / jalankan ulang installer | brew upgrade tesseract | sudo apt upgrade tesseract-ocr |
| Hapus | winget uninstall UB-Mannheim.TesseractOCR | brew uninstall tesseract | sudo apt remove tesseract-ocr |
| Banyak versi | Sisakan satu di PATH | Jangan campur brew dan MacPorts | Gunakan PPA atau kompilasi dari sumber |
Pemecahan masalah
Kasus berikut mencakup sebagian besar masalah instalasi.
| Gejala | Penyebab | Solusi |
|---|---|---|
tesseract: command not found | Folder instalasi tidak ada di PATH | Tambahkan C:\Program Files\Tesseract-OCR (Windows) atau bin brew (macOS) ke PATH lalu mulai ulang terminal. |
Error opening data file .../eng.traineddata | Data bahasa hilang atau jalur salah | Instal paket bahasa atau setel TESSDATA_PREFIX ke folder yang berisi eng.traineddata. |
TesseractNotFoundError (Python) | pytesseract tidak menemukan biner | Setel pytesseract.pytesseract.tesseract_cmd ke jalur lengkap atau perbaiki PATH. |
| Versi salah | Ada lebih dari satu instalasi di PATH | Urutkan ulang PATH atau hapus duplikat; which -a tesseract / where tesseract. |
| Akses ditolak | Instalasi sistem tanpa hak | Gunakan sudo di Linux, atau scoop/Conda untuk instalasi tingkat pengguna. |
| Docker tidak menemukan gambar | Volume tidak di-mount | Mount folder dengan -v "$PWD:/data" dan gunakan /data/... di dalam kontainer. |
FAQ instalasi
Bagaimana cara menginstal Tesseract OCR di Windows?
Unduh installer UB Mannheim untuk Tesseract 5.x, jalankan, tambahkan C:\Program Files\Tesseract-OCR ke PATH, lalu verifikasi dengan tesseract --version. Anda juga bisa memakai winget, scoop, atau chocolatey.
Bagaimana cara menginstal Tesseract OCR di Ubuntu?
Jalankan sudo apt update && sudo apt install tesseract-ocr libtesseract-dev. Aktifkan repositori universe jika perlu, dan instal tesseract-ocr-all untuk semua bahasa.
Di mana Tesseract diinstal?
Windows: C:\Program Files\Tesseract-OCR. macOS dengan Homebrew: /opt/homebrew (Apple Silicon) atau /usr/local (Intel). Linux: biasanya /usr/bin/tesseract, data di /usr/share/tesseract-ocr/.
Apakah saya perlu menginstal sesuatu untuk Python?
Ya. Pembungkus pytesseract memanggil biner Tesseract, jadi instal mesinnya dulu, lalu pip install pytesseract pillow. Dokumentasi menunjukkan contoh minimal.
Bisakah saya menginstal tanpa hak administrator?
Bisa. Gunakan scoop atau versi portabel di Windows, atau conda install -c conda-forge tesseract di sistem apa pun.
Apakah Tesseract gratis untuk penggunaan komersial?
Ya. Tesseract dirilis di bawah lisensi Apache 2.0 dan gratis untuk penggunaan pribadi, akademik, maupun komersial.
Langkah berikutnya
Setelah mesin terpasang, pelajari cara menggunakannya.