tesseract-heb-rivok
heb_rivok and heb_rivok_lite are
Tesseract 5 models for printed Hebrew, fine-tuned by Rivok Labs.
This package installs them with pip and tells Tesseract where they are. You still need
Tesseract itself (apt install tesseract-ocr, brew install tesseract, or the Windows
installer).
pip install tesseract-heb-rivok
| model | for | version |
|---|---|---|
heb_rivok |
Hebrew documents with English words and numbers, old print and niqqud. English is in the model, so no +eng |
2.0 |
heb_rivok_lite |
Hebrew and niqqud, about as fast as the standard heb model; add +eng for English |
2.0 |
Using heb_rivok in a project or product? We'd love to hear about it: ronen@rivoklabs.com.
The files are the integer ("fast") models from the
GitHub release. The float
models are there too: heb_rivok's float file reads vowels a little better, at about 1.3× the
time per line, and both are the starting point for further fine-tuning.
Use
python -m tesseract_heb_rivok prints the folder that holds the two models:
tesseract page.png out --tessdata-dir "$(python -m tesseract_heb_rivok)" -l heb_rivok
From Python with pytesseract:
import pytesseract
import tesseract_heb_rivok
text = pytesseract.image_to_string(
"page.png", lang="heb_rivok",
config=f'--tessdata-dir "{tesseract_heb_rivok.tessdata_dir()}"')
When Tesseract needs more than these two models. Some uses need Tesseract's own files
as well: another language (-l heb_rivok_lite+eng), page rotation (osd) or output
configs (hocr, pdf). OCRmyPDF and Docling need them too. For these, use the merged
folder: --merged builds a folder in your cache that links these models and everything in
your system's tessdata.
export TESSDATA_PREFIX="$(python -m tesseract_heb_rivok --merged)"
ocrmypdf -l heb_rivok scanned.pdf searchable.pdf
tesseract page.png out -l heb_rivok_lite+eng hocr
Docling, with its Tesseract command-line engine:
import os
import tesseract_heb_rivok
from docling.datamodel.pipeline_options import OcrMode, PdfPipelineOptions, TesseractCliOcrOptions
tessdata = tesseract_heb_rivok.merged_tessdata_dir()
os.environ["TESSDATA_PREFIX"] = tessdata # Docling lists languages without --tessdata-dir
opts = PdfPipelineOptions()
opts.ocr_options = TesseractCliOcrOptions(lang=["heb_rivok"], path=tessdata, mode=OcrMode.FULL_PAGE)
python -m tesseract_heb_rivok --check verifies the files and that Tesseract loads them.
Results
Character error rate, lower is better; fast models, Tesseract 5.5.0.
| test | heb (Ubuntu/Debian) |
heb_rivok_lite | heb_rivok |
|---|---|---|---|
| 150 line crops from real Hebrew documents | 4.7% | 1.7% | 1.2% |
| Four old books (1872–1922), 1,087 lines | 11.3% | 4.8% | 2.7% |
| … the vowelled Selichot 1885: vowel marks read (higher is better) | 23% | 61% | 82% |
| GlotOCR-bench Hebrew, clean images | 21.2% | 13.2% | 10.9% |
| HaZefira newspaper, 4,013 line crops | 17.5% | 6.3% | 4.8% |
Method, more tests and how the models were trained are in the
model card. The 150 crops come
from private documents; the four old books are public-domain scans with Hebrew Wikisource
transcriptions; GlotOCR-bench and HaZefira are public, and the repository's eval/ scripts
rerun those numbers.
Files
| file | SHA-256 |
|---|---|
heb_rivok.traineddata (5.7 MB) |
09ef1830f3393c590791abf9c18deca14450c8e5d3b556249d63b0183cf7a426 |
heb_rivok_lite.traineddata (3.5 MB) |
59da073ad0bca9449fa5a965996e49d0e2bee3c17e8b0b4e2769d67a7ce34c40 |
Licence
Apache-2.0, like the tessdata_best models and langdata_lstm text they are built on.
Metadata
Release files for tesseract-heb-rivok 2.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tesseract_heb_rivok-2.0.0.tar.gz | 4.1 MB | Without provenance | Details for tesseract_heb_rivok-2.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tesseract_heb_rivok-2.0.0-py3-none-any.whl | Python 3 | none | any | Details for tesseract_heb_rivok-2.0.0-py3-none-any.whl |
Total release size: 8.3 MB
Release files / tesseract_heb_rivok-2.0.0.tar.gz
| Download URL | tesseract_heb_rivok-2.0.0.tar.gz |
|---|---|
| Size | 4.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
29bbf2d98c0693d63ae07bb909d6fc561dd9c243eaba31e1f6e222eb0a7b640f
|
|
BLAKE2b-256 checksum How to use checksums |
f75cb5fac3b52f0488508fcc1c80121e6c4d3fd665cd4fcc6a9f6e8fc21beee3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.16
|
Release files / tesseract_heb_rivok-2.0.0-py3-none-any.whl
| Download URL | tesseract_heb_rivok-2.0.0-py3-none-any.whl |
|---|---|
| Size | 4.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
94c2654a88de52b8a307d6c8cb17a6a7a2e43dfecf9cc2999c375a4e18d61a1d
|
|
BLAKE2b-256 checksum How to use checksums |
9d9a7185cc60eaabc18c865d0f1085917912e802316175c2b262b7c17e8a8726
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.16
|
Security for tesseract-heb-rivok 2.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.