| --- |
| language: |
| - bn |
| - en |
| license: mit |
| tags: |
| - ocr |
| - bengali |
| - object-detection |
| - text-recognition |
| - yolov8 |
| pipeline_tag: object-detection |
| --- |
| |
| # ShobdoOCR — Bangla-English OCR for Bangladeshi Documents |
|
|
| ShobdoOCR is a word-level OCR system designed for Bangladeshi government documents including NID cards, birth certificates, land deeds, and invoices. It handles mixed Bengali and English text using a classifier-first dual-recognizer architecture — a lightweight 23K-parameter script classifier (99.82% accuracy) routes each detected word to either a Bengali CRNN or English CRNN recognizer, returning per-word bounding boxes, recognized text, and script labels. |
|
|
| Part of the **DocReader BD** intelligent document understanding system. |
|
|
| --- |
|
|
| ## Install |
|
|
| ```bash |
| pip install --index-url https://test.pypi.org/simple/ \ |
| --extra-index-url https://pypi.org/simple/ \ |
| shobdoocr==0.1.1 |
| ``` |
| > Note: shobdoocr is currently hosted on TestPyPI (test registry). |
| > Dependencies are fetched from the official PyPI automatically. |
|
|
| --- |
|
|
| ## Usage |
|
|
| ```python |
| from shobdoocr import OCR |
| |
| ocr = OCR() # models download automatically (~80MB) |
| |
| # Plain text |
| text = ocr.read_text("nid_card.jpg") |
| print(text) |
| |
| # Word-level output with bounding boxes and script labels |
| results = ocr.read("nid_card.jpg") |
| for word in results: |
| print(word['text'], word['script'], word['box']) |
| ``` |
