Evidence-Based ATS Compliance & Job Matching Intelligence
Truth over hype. Trust over vanity metrics.
View More Screenshots
| Resume Analysis | Score Breakdown |
|---|---|
 |
 |
| AI Explainability | Skills Detection |
|---|---|
 |
 |
| HITL Rewrite |
|---|
 |
VeriFit is a governance-first, evidence-based system designed to evaluate resumes for ATS compliance, role fit, and job alignment without exaggeration, hallucination, or opaque scoring.
Unlike traditional resume "optimizers," VeriFit operates as a truth mirror:
- ✅ Scores resumes using deterministic, explainable criteria
- ✅ Matches candidates only with real, active job roles
- ✅ Enforces human-in-the-loop approvals for any generative change
- ✅ Prioritizes fairness, auditability, and regulatory compliance
Built for candidates, recruiters, and enterprises that value accuracy over hype.
| Feature | Description |
|---|---|
| 📄 Smart Parsing | LLM-powered resume extraction with regex fallback |
| 📊 Evidence-Based Scoring | Every score backed by specific findings |
| 🧠 AI Explainability (XAI) | "Why this score?" with reasoning chains |
| ✍️ HITL Rewrite | AI suggestions with diff view, requires human approval |
| 🔒 Privacy-First | No data retention, no training on user data |
| 🎨 Modern UI | Material You design with interactive flashcards |
| Component | Technology | Version |
|---|---|---|
| Backend | Flask + Python | 3.11+ |
| Frontend | React + Vite | 19.2 |
| LLM | Google Gemini | 2.5 Flash |
| UI Framework | Material UI | 7.x |
| Animations | Framer Motion | 12.x |
- Python 3.11+
- Node.js 18+
- Google API Key
# Clone repository
git clone https://github.com/VIKAS9793/VeriFit.git
cd VeriFit
# Backend setup
python -m venv venv
.\venv\Scripts\activate # Windows
pip install -r requirements.txt
# Configure API key
cp .env.example .env
# Edit .env and add GOOGLE_API_KEY
# Frontend setup
cd client && npm install# Terminal 1: Backend
python -m src.app
# Terminal 2: Frontend
cd client && npm run dev📖 See docs/SETUP.md for detailed instructions.
| Document | Description |
|---|---|
| SYSTEM.md | Non-negotiable system principles |
| docs/ARCHITECTURE.md | System architecture with diagrams |
| docs/SETUP.md | Installation guide |
| docs/TROUBLESHOOTING.md | Common issues & solutions |
| docs/adr/ | Architecture Decision Records |
From SYSTEM.md:
- Truth Over Optimization — Refuses hallucination, exaggeration, or inference
- Explainability First — Every score and decision is auditable
- Human-in-the-Loop — Generative actions require approval with diffs
- Privacy-Preserving — DPDP compliant, consent-first, no training on user data
See CONTRIBUTING.md for guidelines.
# Run tests
python -m pytest tests/ -v
# Frontend lint
cd client && npm run lint|
VIKAS SAHANI @VIKAS9793 📧 vikassahani17@gmail.com |
MIT License © 2025 Vikas Sahani
"If your resume needs lies to pass ATS, the problem isn't your resume—it's the role."