Built for Google Developer Groups Hackathon · Pune 2026
Recruit IQ is an intelligent recruiter assistant that eliminates the manual effort of resume screening. A recruiter pastes a Job Description, uploads a batch of candidate PDFs, and within seconds gets a ranked shortlist.
The system doesn't just match keywords. It understands context, infers candidate strength, and provides a hiring verdict (Strong Hire / Hire / Maybe / No Hire) with a one-liner rationale for every candidate.
Deployed App: https://recruitiq-gdg-pune.vercel.app
Watch on YouTube: https://youtu.be/l4NXQKvVa-0
The recruiter pastes the full Job Description (or uses a quick-seed template for roles like Senior ML Engineer at Flipkart or Lead AI Researcher at IIT Bombay Hub), then uploads a batch of candidate PDFs for evaluation.
After Gemini evaluates each candidate, the leaderboard shows candidates ranked by AI score with verdicts like Strong Hire (91%), Hire (87%), etc. Each card includes the candidate's current role and a one-line justification.
- Deep JD Understanding — extracts skills, experience level, responsibilities, and success criteria
- Holistic Candidate Scoring — evaluates career trajectory, skill depth, impact signals — not just keywords
- Transparent Ranking — every candidate gets a 0-100 fit score with clear reasoning
- Explainable Shortlists — strengths, concerns, and severity levels per candidate
- Interview Question Generator — tailored technical and behavioral questions per candidate
- Verdict System — Strong Hire / Hire / Maybe / No Hire / Strong No Hire
- PDF Resume Support — drag and drop multi-PDF upload with instant text extraction
| Layer | Technology |
|---|---|
| Frontend | React 18, Vite, Tailwind CSS, Framer Motion |
| Backend | FastAPI, Python, pdfplumber |
| AI | Google Gemini 2.0 Flash |
| PDF Parsing | pdfplumber |
| State | localStorage (client-side) |
- Python 3.10+
- Node.js 18+
- Google Gemini API Key → aistudio.google.com
cd backend
pip install -r requirements.txt
cp .env.example .env # add your GEMINI_API_KEY
uvicorn main:app --reloadcd frontend
npm install
npm run devFrontend runs on http://localhost:5173 — Backend on http://localhost:8000