Tesseract OCR Kurulumu
dakikalar içinde.
Windows, macOS, Linux, WSL2, Docker ve Conda için eksiksiz ve test edilmiş kurulum rehberi; PATH ayarı, dil verileri, doğrulama ve en sık karşılaşılan hataların çözümleri dahil.
Hızlı kurulum (tek komut)
Platformunuza uygun komutu kopyalayın. Diller ve PATH aşağıda ayrıntılı anlatılmıştır.
Windows
Paket yöneticileri veya UB Mannheim kurulumu.
> winget install UB-Mannheim.TesseractOCR
macOS
Homebrew önerilen yöntemdir.
$ brew install tesseract
Ubuntu / Debian
Resmî depolarda mevcut.
$ sudo apt install tesseract-ocr
Hangi kurulum yöntemini seçmeliyim?
Ortamınıza uyan satırı seçin. Rehberin geri kalanı her yöntemi ayrıntılı anlatır.
| Yöntem | Kimler için | Dil verisi | Yönetici hakları |
|---|---|---|---|
| UB Mannheim kurulumu (Windows) | Çoğu Windows kullanıcısı | Kurulumda seçilir | Evet (sistem geneli) |
| winget / scoop / choco | Betik veya kullanıcı düzeyinde Windows kurulumu | Ayrıca eklenir | scoop: hayır |
| Homebrew / MacPorts (macOS) | macOS geliştirme | tesseract-lang | Hayır |
| apt / dnf / pacman / apk | Linux sunucu ve masaüstü | Dile göre paketler | Evet (sudo) |
| WSL2 | Model de eğiten Windows kullanıcıları | apt paketleri | Hayır |
| Docker | Yeniden üretilebilir servisler ve CI | İmaja dahil | Hayır |
| Conda | Veri bilimi ortamları | conda-forge | Hayır |
Windows'ta kurulum
Tesseract Windows'ta kolayca derlenmez. Topluluk kurulumunu veya bir paket yöneticisini kullanın, ardından PATH'e ekleyin.
Seçenek A — UB Mannheim kurulumu (önerilir)
UB Mannheim projesi Tesseract 5.x için Windows standart derlemelerini (64 ve 32 bit) yayınlar. Kurulum, eğitim araçlarını içerir ve dil seçmenize izin verir.
- UB Mannheim sayfasından en yeni
tesseract-ocr-w64-setup-5.x.exedosyasını indirin. - Kurulumu çalıştırın ve gereken dilleri (veya tümünü) seçin.
- Varsayılan konuma kurun:
C:\Program Files\Tesseract-OCR. - Bu klasörü PATH'e ekleyin (aşağıda) ve terminali yeniden başlatın.
Seçenek B — paket yöneticileri
> winget search tesseract
> winget install UB-Mannheim.TesseractOCR
> scoop install tesseract
> choco install tesseract
Paket kimlikleri zamanla değişir: komut çalışmazsa winget search tesseract veya scoop search tesseract çalıştırın.
Tesseract'ı PATH'e ekleme (herkesin atladığı adım)
UB Mannheim kurulumunu kullandıysanız, klasör PATH'te olana kadar tesseract bulunamaz.
- Başlat menüsünü açın, Ortam Değişkenleri arayın ve Sistem ortam değişkenlerini düzenle seçeneğini seçin.
- Ortam Değişkenleri… öğesine tıklayın, Sistem değişkenleri altında Path öğesini seçip Düzenle'ye tıklayın.
- Yeni'ye tıklayıp
C:\Program Files\Tesseract-OCRekleyin. - Tümünü onaylayın ve terminali (ve IDE'yi) tamamen yeniden başlatın.
> tesseract --version
macOS'ta kurulum
Hem Apple Silicon hem Intel için önerilen yöntem Homebrew'dur.
$ brew install tesseract
$ brew install tesseract-lang # tüm diller
Homebrew ikili dosyaları /opt/homebrew/bin (Apple Silicon) veya /usr/local/bin (Intel) altına kurar. Dil verileri tessdata klasöründedir; brew info tesseract ile bulabilirsiniz.
MacPorts alternatifi
$ sudo port install tesseract
$ sudo port install tesseract-dilkodu # örn. tesseract-fra
Linux'ta kurulum
Tüm büyük dağıtımlar Tesseract'ı resmî depolarında sunar.
Debian / Ubuntu / Mint
$ sudo apt update
$ sudo apt install tesseract-ocr libtesseract-dev
$ sudo apt install tesseract-ocr-all # isteğe bağlı: tüm diller
apt paketi bulamazsa universe deposunu etkinleştirin. libtesseract-dev yalnızca API'ye karşı derleme yaparken gerekir.
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
Daha yeni bir sürüm mü gerekiyor? resmî derleme kılavuzunu izleyerek kaynaktan derleyin.
Windows'ta WSL2 ile kurulum
WSL2, Windows içinde tam bir Linux ortamı sunar; model eğitmek de istiyorsanız en kolay yoldur.
> wsl --install -d Ubuntu
$ sudo apt update && sudo apt install tesseract-ocr tesseract-ocr-all libtesseract-dev
Docker ile kurulum
Yeniden üretilebilir servisler ve CI için Tesseract'ı sabit sürüm ve dillerle bir imaja dahil edin.
Bir Dockerfile oluşturun:
FROM ubuntu:24.04
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
tesseract-ocr tesseract-ocr-eng tesseract-ocr-tur 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
Bir birim bağlayın; böylece Tesseract görseli okur ve out.txt dosyasını ana makineye yazar. Daha fazla dil için Dockerfile'a tesseract-ocr-<dil> paketleri ekleyin.
Conda ile kurulum
Sistem paket yöneticisini kullanamadığınız veri bilimi ortamları için idealdir.
$ conda install -c conda-forge tesseract
Dil verilerini kurma (tessdata)
Motor varsayılan olarak İngilizce içerir. Diğer dilleri paket ya da .traineddata dosyası olarak ekleyin.
Dil paketlerini kurma
$ sudo apt install tesseract-ocr-fra tesseract-ocr-deu # Debian/Ubuntu
$ brew install tesseract-lang # macOS (tümü)
$ sudo dnf install tesseract-langpack-fra # Fedora
.traineddata dosyasını elle kurma
- Dil dosyasını resmî depolardan indirin: tessdata_fast (hız), tessdata_best (doğruluk) veya tessdata (eski).
.traineddatadosyasınıtessdataklasörüne kopyalayın (örn.C:\Program Files\Tesseract-OCR\tessdata,/usr/share/tesseract-ocr/5/tessdataveya$(brew --prefix)/share/tessdata).- Veriler başka yerdeyse
TESSDATA_PREFIXortam değişkeniyle belirtin. - Kullanılabilir dilleri
tesseract --list-langsile doğrulayın.
| Depo | Ödünleşim | Ne zaman kullanılır |
|---|---|---|
tessdata_fast | En küçük ve en hızlı, biraz daha düşük doğruluk | Gerçek zamanlı veya yüksek hacimli iş akışları |
tessdata_best | En yüksek doğruluk, daha yavaş ve büyük | Arşivleme veya doğruluğun kritik olduğu işler |
tessdata | Eski + LSTM, --oem 0 destekler | Eski modeller veya eski uyumluluk |
Kurulumu doğrulama
Devam etmeden önce bu üç kontrolü yapın. Biri başarısız olursa sorun giderme tablosuna bakın.
$ tesseract --version
$ tesseract --list-langs
$ tesseract ornek.png stdout -l eng
Başarılı bir çalıştırma sürümü gösterir, eng (ve kurulu dilleri) listeler ve görselinizden tanınan metni döndürür.
Güncelleme, yönetme ve kaldırma
Motoru güncel tutun veya temiz şekilde kaldırın.
| Görev | Windows | macOS | Linux |
|---|---|---|---|
| Güncelle | winget upgrade / kurulumu yeniden çalıştır | brew upgrade tesseract | sudo apt upgrade tesseract-ocr |
| Kaldır | winget uninstall UB-Mannheim.TesseractOCR | brew uninstall tesseract | sudo apt remove tesseract-ocr |
| Çoklu sürüm | PATH'te yalnızca bir tane bırakın | brew ile MacPorts'u karıştırmayın | PPA kullanın veya kaynaktan derleyin |
Sorun giderme
Bu durumlar kurulum sorunlarının büyük çoğunluğunu kapsar.
| Belirti | Neden | Çözüm |
|---|---|---|
tesseract: command not found | Kurulum klasörü PATH'te değil | C:\Program Files\Tesseract-OCR (Windows) veya brew bin (macOS) klasörünü PATH'e ekleyip terminali yeniden başlatın. |
Error opening data file .../eng.traineddata | Dil verisi eksik veya yol yanlış | Dil paketini kurun ya da TESSDATA_PREFIX değerini eng.traineddata içeren klasöre ayarlayın. |
TesseractNotFoundError (Python) | pytesseract ikili dosyayı bulamıyor | pytesseract.pytesseract.tesseract_cmd değerini tam yola ayarlayın veya PATH'i düzeltin. |
| Yanlış sürüm | PATH'te birden fazla kurulum var | PATH sırasını değiştirin veya kopyayı kaldırın; which -a tesseract / where tesseract. |
| Erişim reddedildi | Yetkisiz sistem kurulumu | Linux'ta sudo, ya da kullanıcı düzeyi için scoop/Conda kullanın. |
| Docker görseli bulamıyor | Birim bağlanmamış | Klasörü -v "$PWD:/data" ile bağlayın ve kapsayıcı içinde /data/... kullanın. |
Kurulum SSS
Tesseract OCR'ı Windows'a nasıl kurarım?
Tesseract 5.x için UB Mannheim kurulumunu indirip çalıştırın, C:\Program Files\Tesseract-OCR klasörünü PATH'e ekleyin ve tesseract --version ile doğrulayın. winget, scoop veya chocolatey de kullanabilirsiniz.
Tesseract OCR'ı Ubuntu'ya nasıl kurarım?
sudo apt update && sudo apt install tesseract-ocr libtesseract-dev çalıştırın. Gerekirse universe deposunu etkinleştirin ve tüm diller için tesseract-ocr-all kurun.
Tesseract nereye kurulur?
Windows: C:\Program Files\Tesseract-OCR. macOS Homebrew: /opt/homebrew (Apple Silicon) veya /usr/local (Intel). Linux: genellikle /usr/bin/tesseract, veriler /usr/share/tesseract-ocr/.
Python için bir şey kurmam gerekir mi?
Evet. pytesseract sarmalayıcısı Tesseract ikili dosyasını çağırır; önce motoru, ardından pip install pytesseract pillow kurun. Belgelerde minimal bir örnek var.
Yönetici hakları olmadan kurabilir miyim?
Evet. Windows'ta scoop veya taşınabilir sürüm, her sistemde conda install -c conda-forge tesseract kullanın.
Tesseract ticari kullanım için ücretsiz mi?
Evet. Tesseract Apache 2.0 lisansıyla dağıtılır ve kişisel, akademik ve ticari kullanım için ücretsizdir.
Sonraki adımlar
Motor kurulduktan sonra nasıl kullanılacağını öğrenin.