README.md

metadata

title: OCR Notification & Data Extractor
emoji: 🧾
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit

OCR Notification & Data Extractor

Upload scanned PDFs or images and turn them into structured, exportable data. Built for teams that need to pull actionable "notification" events and key fields out of paper-heavy workflows:

• Construction / SAP data support — change orders, delay notices, punch list items, RFIs, PO numbers, SAP document numbers, quantities.
• Compliance — non-conformances, violations, expirations, corrective actions, certification codes (ISO, OSHA, ASTM, ANSI).
• Business finance — past-due invoices, payment rejections, credit holds, invoice numbers, dollar amounts, due dates.

How it works

1. Upload one or more PDFs or images.
2. Each page's text is pulled directly from the PDF when it has a text layer; scanned/image-only pages are rendered and run through Tesseract OCR.
3. The text is scanned against keyword sets for the categories you pick (or your own custom keywords), and structured fields (PO/SAP/invoice numbers, dates, dollar amounts, percentages, certification codes) are pulled out with regex.
4. Results are shown in a table and exported as a CSV, one row per page that has a hit (or every page, if you turn that filter off).

Local development

pip install -r requirements.txt
# Tesseract must also be installed on the system, e.g.:
#   apt-get install tesseract-ocr
python app.py

Files

• app.py — Gradio UI and orchestration.
• ocr_engine.py — PDF/image loading and OCR (PyMuPDF + Tesseract).
• extractors.py — keyword notification scanning and structured field extraction (regex-based, easy to extend per domain).