ncnn-ocr

Production-ready Python OCR built on PaddleOCR PP-OCR Mobile models running on Tencent NCNN.

Standalone, publishable to PyPI, and independent of Qefro.

Features

• Fast CPU inference — NCNN-backed det + cls + rec pipeline (same engine as PaddleOCR-ncnn-CPP)
• PP-OCRv5 multilingual — Tamil, Arabic, Devanagari, Latin, Korean, Cyrillic, and more
• PP-OCRv6 profiles — v6_tiny, v6_small, v6_medium
• Simple API — recognize(), recognize_text(), batch()
• Auto model download — pulls weights from developerabu/pp-OCRv5-6-ncnn on first use
• Arabic post-processing — optional visual-order → logical-order fix

Install

From source (requires native deps)

# macOS (Homebrew)
brew install cmake opencv ncnn

# Debian/Ubuntu
sudo apt install cmake libopencv-dev libomp-dev

# Build ncnn if not packaged (see https://github.com/Tencent/ncnn)
export NCNN_DIR=$HOME/.local/ncnn   # optional, CMake searches common paths

pip install .

Python dependencies only (no extension)

Pure-Python modules import without the _ncnn_ocr extension; OCR() raises a clear error until the native module is built.

Quick start

from ncnn_ocr import OCR

ocr = OCR(lang="ta")
text = ocr.recognize_text("page.png")
print(text)

lines = ocr.recognize("page.png")
for line in lines:
    print(line.text, line.confidence, line.box)

One-shot helpers:

from ncnn_ocr import recognize_text

print(recognize_text("scan.jpg", lang="en"))

Supported languages (PP-OCRv5)

from ncnn_ocr import supported_langs
print(supported_langs())

PP-OCRv6

ocr = OCR(lang="en", profile="v6_tiny")
text = ocr.recognize_text("page.png")

Profiles: v6_tiny, v6_small, v6_medium.

Environment variables

Build layout

py-ocr-ncnn/
├── src/ncnn_ocr/       # Python package
├── native/
│   ├── bindings.cpp    # pybind11 wrapper
│   └── paddleocr/      # vendored NCNN OCR engine (Apache-2.0)
├── CMakeLists.txt
└── pyproject.toml

Models

On first run, recognition models and keys are downloaded from HuggingFace. Shared PP-OCRv5 detection and angle-classifier weights are fetched from HuggingFace when available, otherwise from the PaddleOCR-ncnn-CPP v0.3.0 archive.

Development

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
PYTHONPATH=src pytest -q

License

Apache-2.0 — see LICENSE. The vendored PaddleOCR-ncnn-CPP sources retain their original license.

Credits

• Avafly/PaddleOCR-ncnn-CPP — NCNN OCR engine
• PaddleOCR — PP-OCR models
• Tencent NCNN — inference framework