Files
familienarchiv/ocr-service/engines/surya.py
Marcel 49975154d9
Some checks failed
CI / Unit & Component Tests (push) Failing after 2s
CI / Backend Unit Tests (push) Failing after 1s
CI / Unit & Component Tests (pull_request) Failing after 1s
CI / Backend Unit Tests (pull_request) Failing after 1s
feat(ocr): bump to latest surya 0.17.1, kraken 7.0, torch 2.7.1
- surya-ocr 0.6.3 → 0.17.1: new predictor API (FoundationPredictor,
  RecognitionPredictor, DetectionPredictor), native polygon output
  on text lines (4-point clockwise)
- kraken 5.2.9 → 7.0: wider torch range (>=2.4,<=2.10), unpinned numpy
- torch 2.5.1 → 2.7.1: satisfies surya's >=2.7.0 requirement
- Rewrite engines/surya.py for the 0.17 predictor class API
- Surya now outputs polygons natively — no longer rectangle-only

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-12 18:53:14 +02:00

65 lines
2.2 KiB
Python

"""Surya OCR engine wrapper — transformer-based, handles typewritten and modern Latin handwriting."""
import logging
logger = logging.getLogger(__name__)
_recognition_predictor = None
_detection_predictor = None
def load_models():
"""Eagerly load Surya models into memory. Called once at container startup."""
global _recognition_predictor, _detection_predictor
logger.info("Loading Surya models...")
from surya.foundation import FoundationPredictor
from surya.recognition import RecognitionPredictor
from surya.detection import DetectionPredictor
foundation_predictor = FoundationPredictor()
_recognition_predictor = RecognitionPredictor(foundation_predictor)
_detection_predictor = DetectionPredictor()
logger.info("Surya models loaded successfully")
def extract_blocks(images: list, language: str = "de") -> list[dict]:
"""Run Surya OCR on a list of PIL images (one per page).
Returns a flat list of block dicts with pageNumber, x, y, width, height,
polygon, text. Coordinates are normalized to [0, 1] relative to page dimensions.
Surya 0.17+ returns polygon (4-point) natively on each text line.
"""
all_blocks = []
predictions = _recognition_predictor(images, det_predictor=_detection_predictor)
for page_idx, page_pred in enumerate(predictions):
page_w, page_h = images[page_idx].size
for line in page_pred.text_lines:
bbox = line.bbox # [x1, y1, x2, y2] in pixel coordinates
x1, y1, x2, y2 = bbox
# Surya 0.17 provides polygon as list of (x, y) tuples (4 points, clockwise)
polygon = None
if hasattr(line, "polygon") and line.polygon and len(line.polygon) == 4:
polygon = [
[p[0] / page_w, p[1] / page_h]
for p in line.polygon
]
all_blocks.append({
"pageNumber": page_idx,
"x": x1 / page_w,
"y": y1 / page_h,
"width": (x2 - x1) / page_w,
"height": (y2 - y1) / page_h,
"polygon": polygon,
"text": line.text,
})
return all_blocks