VeriDraft — Identity Verification Starter Kit
Self-hosted identity-verification starter kit with real OCR, real face-matching, and a liveness-check prototype — for developers and agencies, not certified KYC/AML.
Description
A self-hosted identity-verification starter kit: Next.js 16 frontend + Python/FastAPI computer-vision engine. Document OCR runs real Tesseract text extraction with OpenCV preprocessing, and face-matching runs real dlib 128-dimension face embeddings for 1:1 comparison — neither is a mockup. Liveness checking includes a genuine server-verified head-pose sequence alongside a separate, clearly-labeled simulated demo mode. Includes an admin review dashboard, HMAC-signed admin session, rate limiting, audit logging, and Docker Compose + Traefik deployment config. Sold as a technical starter kit to build on, not a certified KYC/AML compliance product.
What Already Works
What's Included
- Full source code (Next.js frontend + Python/FastAPI engine)
- README and setup guide
- InMyDraft Commercial License
- AI-ready docs pack (PRD, architecture, API, database, security, model card, threat model)
- Bundled CC0-licensed dlib face models
- Backend pytest suite
How to Run
- Unzip the source.
- Copy .env.example to .env and run python3 scripts/generate_secrets.py.
- Fastest path: docker compose up --build -d, then open http://127.0.0.1:3100/en.
- Frontend-only path: cd apps/web, npm install, npm run dev (OCR/face-matching require the Python engine via Docker).
Continuation Notes
- Rotate all default secrets (ADMIN_SESSION_SECRET, ENGINE_ADMIN_API_KEY, etc.) via scripts/generate_secrets.py before any real deployment — never reuse the sample .env values.
Known Limitations
- Not certified for KYC/AML regulatory compliance — sold as a technical starter kit, not a finished compliance product
- Liveness check ships with a clearly-labeled simulated demo mode alongside the real server-verified flow
- Requires Tesseract 5.x, dlib, and a working Docker/Python environment — nontrivial setup for non-developers
- Demo sample images use public-domain reference photos (disclosed in THIRD_PARTY_NOTICES.md), not real ID documents
Related Drafts
Personal Finance Tracker
Half-built but running web app draft for tracking personal income, expenses, and simple cashflow habits.
BatuWorkout Class Booking
Workout class booking draft with public schedule pages, booking/member/admin screens, and manual-payment MVP direction.