Server-side ID document recognition (OCR, MRZ, barcode, and credit-card reading) for Linux, exposed through a Python interface with ready-to-run Flask and Gradio demos.
Part of the FaceOnLive on-premises biometric SDK suite.
- OCR + MRZ parsing for passports, ID cards, and driver's licenses.
- Credit-card and barcode reading.
- On-premises and offline; REST (Flask) and web-UI (Gradio) demos included.
| OS | Linux x86-64 |
| Runtime | Python 3.8+ |
| Engine | native OCR engine (included under engine/) |
- Get a license key — free trial at https://faceonlive.com.
- Provide the key via the
LICENSE_KEYenvironment variable, orlicense.txt(replace the<YOUR_LICENSE_KEY>placeholder). - Install requirements, then run a demo:
python flask/app.py # REST API python gradio/app.py # web UI
from engine.header import *
set_activation(license_key.encode("utf-8")) # TTVOcrSetActivation
init_sdk() # TTVOcrInit
result = ocr_id_card(image) # TTVOcrProcess → JSON| Binding | Native | Description |
|---|---|---|
get_deviceid() |
TTVOcrGetHWID |
Machine hardware ID (for offline licensing). |
set_activation(key) |
TTVOcrSetActivation |
Activate the SDK. |
init_sdk() |
TTVOcrInit |
Initialize the engine. |
ocr_id_card(image) |
TTVOcrProcess |
Recognize an ID document → JSON. |
ocr_credit_card(image) |
TTVOcrCreditCard |
Read a credit/debit card. |
ocr_barcode(image) |
TTVOcrBarCode |
Read a barcode / QR code. |
Requires a valid license key — get one at faceonlive.com. Keep license.txt out of version control. Questions: contact@faceonlive.com
This repository contains the source/demo code only. Download the complete SDK — engine libraries and models, with full project structure — from the Releases page and extract it over this project.