idverify

ID verification library — OCR, MRZ parsing, screenshot detection, and age gate for government IDs.

Built by ᗰᗩOᑌ · GitHub

Install

pip install idverify

Usage

from idverify import verify_id, check_age

with open('./passport.jpg', 'rb') as f:
    buffer = f.read()

# Full verification
result = verify_id(buffer)
print(result.status)                 # "valid" | "expired" | "invalid"
print(result.documentType)           # "passport" | "drivers_license" | ...
print(result.checksum)               # "passed" | "failed" | "not_applicable"
print(result.screenshotDetected)     # False

# Age gate only (no birthdate exposed)
age = check_age(buffer)
print(age.over18)  # True
print(age.over21)  # False

API

verify_id(buffer: bytes) -> VerificationResult

Accepts an image buffer (PNG, JPG, WebP). Returns:

check_age(buffer: bytes) -> AgeGateResult

Returns { over18: bool, over21: bool } without exposing the full birthdate.

How it works

1. Preprocessing — OpenCV resizes, grayscales, normalizes, and sharpens the image
2. OCR — pytesseract extracts all text
3. MRZ parsing — looks for Machine Readable Zone lines, validates checksums with the mrz package
4. Fallback extraction — regex-based date and country parsing if no MRZ found
5. Screenshot detection — exifread checks for camera EXIF metadata (Make, Model)
6. Age gate — calculates age from DOB without returning the raw date

Requirements

• Python 3.9+
• Tesseract OCR installed on your system

Install Tesseract

License

MIT