retinrix/retin-verify-v3

Computer Vision-Based Algerian ID Card Verification - V3 # Retin-Verify V3 Computer Vision-Based Algerian ID Card Verification ## Overview Retin-Verify V3 is a pure computer vision solution for verifying Algerian ID cards without chip reading. It extracts and validates MRZ (Machine Readable Zone), detects security features, and performs tampering detection. **License:** MIT (Free for commercial use) ## Features - ✅ **Document Detection** - Automatic ID card localization - ✅ **MRZ Extraction & OCR** - Supports Arabic and Latin text - ✅ **MRZ Validation** - ICAO 9303 check digit verification - ✅ **Face Detection** - Extract face photo for biometric comparison - ✅ **Security Feature Analysis** - Hologram, laser photo detection - ✅ **Tampering Detection** - Error level analysis, copy-move detection ## Technology Stack All components are open-source with **non-AGPL licenses** (free for commercial use): | Component | License | Purpose | |-----------|---------|---------| | PaddleOCR | Apache-2.0 | OCR (Arabic + Latin support) | | OpenCV | Apache-2.0 | Computer vision | | PyTorch | BSD-3 | Deep learning | | YuNet | Apache-2.0 | Face detection | | FastAPI | MIT | Web API | ## Installation ### Prerequisites - Python 3.10+ - CUDA (optional, for GPU acceleration) ### Setup ```bash # Clone repository git clone github.com cd retin-verify-v3 # Create virtual environment python -m venv venv source venv/bin/activate # Linux/Mac # or: venv\Scripts\activate # Windows # Install dependencies pip install -r requirements.txt # Run tests pytest tests/ -v ``` ## Usage ### Command Line ```python from src.utils.mrz_utils import parse_mrz # Parse MRZ from OCR output mrz_lines = [ "IDDZA1154521568<<<<<<<<<<<<<<<", "6703174M2908236DZA<<<<<<<<<<<8", "BOUTIGHANE<