tshabebe/Ethiopian-ID-Card-Generator

# Ethiopian ID Card Generator Generate Ethiopian ID cards from PDF documents with automatic data extraction and QR code generation. ## Features - 📄 Extract data from Ethiopian ID PDFs - 🖼️ Generate front and back ID cards - 🔍 QR code generation and decoding - 📊 Tkinter GUI with table view - 🌐 Web interface for file upload - 📥 Batch PDF download - ✅ Real-time toast notifications - 🎯 **Enhanced address & FAN extraction** (80%+ accuracy) - 🔧 **Smart OCR preprocessing** for different phone cameras - 📸 **Debug visualization tools** for troubleshooting ## Recent Improvements ### Address & FAN Extraction (v2.0) We've significantly improved the accuracy of address and FAN number extraction: - **Address accuracy**: Improved from ~57% to **80-85%** - **FAN accuracy**: Improved to **80-90%** - **Better OCR**: Multiple preprocessing methods for different image qualities - **Smart region detection**: Adapts to low-res and high-res images - **Debug tools**: Visualize extraction regions and OCR quality 📖 **See EXTRACTION_IMPROVEMENTS_README.md for details** ### Testing Your Data ```bash # Test single ID card python test_extraction.py front.jpg back.jpg # Test batch (all your cards) python test_extraction.py --batch ./my_cards/ # Visualize extraction regions python visualize_regions.py back.jpg ``` ## Requirements - Python 3.8+ - Tkinter (for GUI) - Required fonts: Noto Sans, Noto Sans Ethiopic ## Installation 1. **Clone the repository** ```bash git clone cd fyida_id ``` 2. **Install system dependencies** ```bash # Ubuntu/Debian sudo apt-get update sudo apt-get install python3-tk tesseract-ocr # macOS brew install python-tk tesseract ``` 3. **Install Python dependencies** ```bash pip install -r requirements.txt ``` 4. **Install fonts** (if not already installed) ```bash # Ubuntu/Debian sudo apt-get install fonts-noto fonts-noto-extra # macOS brew tap homebrew/cask-fonts brew install font-noto-sans font-noto-sans-ethiopic ``` ## Usage ### Start the Application ` …