Skip to content

edunelsonit/VerixamIR

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Verixam IR (Image Resizer & AI Validator) 🚀

One Capture. Every Exam. Verixam IR is a professional utility designed for over 20,000 examination centers across Nigeria and West Africa. It solves the "Bad Image" crisis for WAEC, NECO, and NABTEB enrollments by providing an automated, AI-ready pipeline for student identity management.

📖 The Story (Inspiration)

It started at a local registration center during the "JAMB rush." I saw a mother pleading with an official because her son’s registration was flagged for a "Bad Image." That mistake didn’t just mean a blurry photo; it meant a heavy penalty fee she couldn't afford and the risk of her son missing a year of school.

In Nigeria, enrollment tools are often manual and unforgiving. I realized that since WAEC already captures high-quality HD data, students shouldn't have to travel or pay to re-capture that same photo for NECO or NABTEB. I built VerixamIR to be the bridge that saves families money and keeps students in the classroom.

✨ Key Features

  • Precision Presets: Instant "One-Click" resizing for WAEC, NECO, and JAMB standards.
  • Database Extraction: Connects to .cnt database files to pull validated student photos and names directly—no re-shooting required.
  • Smart Byte-Size Logic: Automatically finds the "sweet spot" (e.g., 12KB) to ensure 100% server acceptance.
  • Batch Processing: Process an entire school's registry in seconds with multi-threaded performance.
  • AI Validation (Beta): Preliminary checks for head centering and background compliance.

🛠️ How We Built It

  • Language: Python 3.10+
  • UI: CustomTkinter for a modern, responsive "2026-ready" interface.
  • Engine: Pillow (PIL) for recursive image compression.
  • Storage: SQLite3 for interfacing with enrollment database schemas.
  • Concurrency: Python threading to keep the UI smooth during heavy batch tasks.

🚀 Accomplishments We're Proud Of

  • The "Extraction" Magic: Pulling a student's HD photo and name from a WAEC file and making it "NECO-ready" in under two seconds.
  • Zero-Penalty Goal: Creating a tool that can save a single school center thousands of Naira in image correction fees.
  • Human-Centric Design: Making professional image processing accessible to school clerks and enrollment agents.

📈 What's Next

  • Full AI Facial Validation: Using OpenCV to auto-reject images with tilted heads or wrong backgrounds.
  • Cloud Repository: A secure sync for agents to access validated images from any location.
  • Mobile Verixam: Bringing the power of image validation to smartphone cameras for rural enrollment.

⚙️ Installation & Usage

  1. Clone the repo:
    git clone [https://github.com/edunelsonit/VerixamIR.git]
    
  2. Install dependencies:
     pip install -r requirements.txt
  3. Run the App:
     python VerixamIR.py
  4. You Can Download the Executable directly to Run on Windows
     [https://github.com/edunelsonit/VerixamIR/blob/main/dist/VerixamIR.exe]
    

About

VerixamIR is a "smart assistant" for exam enrollment officers. Instead of wrestling with Photoshop or online croppers that ruin image quality, officers can process an entire school’s worth of students in minutes. It automatically snaps images to the exact pixel requirements of WAEC, NECO, and JAMB. Most importantly, it "talks" to existing WAEC data

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors