🚀 AI Candidate Ranking & Shortlisting Engine

AI-powered resume screening that ranks candidates in seconds. Save 5-12 hours per role with intelligent analysis, red flag detection, and detailed scoring.

---

⚡ Quick Start Guide

1️⃣ Setup Backend

# Navigate to backend folder
cd backend

# Create virtual environment
python -m venv venv

# Activate it
venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Create .env file and add your OpenAI API key
copy .env.example .env
# Edit .env: OPENAI_API_KEY=sk-your-key-here

2️⃣ Setup Frontend

# Open NEW terminal, navigate to frontend
cd frontend

# Install dependencies
npm install

3️⃣ Run the System

Terminal 1 - Backend:

cd backend
venv\Scripts\activate
python main.py

✅ Backend running on http://localhost:8000

Terminal 2 - Frontend:

cd frontend
npm run dev

✅ Frontend running on http://localhost:3000

4️⃣ Open Demo

Go to http://localhost:3000 in your browser

---

Demo Instructions

Step 1: Upload Resumes

1. Drag & drop 10-20 resume files (PDF, DOCX, or TXT)
2. Click "Next: Job Description"

Step 2: Fill Job Details

Job Title: Senior Full-Stack Developer

Description: Looking for experienced developer with React and Python expertise

Required Skills: 
- Click + button
- Add: React, Python, FastAPI, PostgreSQL

Preferred Skills:
- Add: TypeScript, Docker, AWS

Experience: 5 years
Salary: 120000 to 160000
Culture Keywords: collaborative, innovative

Step 3: Analyze

• Click "Analyze Candidates"
• Watch the AI process all resumes (30-60 seconds)
• View ranked results with scores, red flags, and insights

Step 4: Export

• Click CSV, Excel, PDF, or ATS JSON to download results

---

🛠️ Tech Stack

Backend: Python, FastAPI, OpenAI GPT-4
Frontend: React, Vite, Tailwind CSS
Features: Resume parsing, AI ranking, Multi-format export

---

🎯 What It Does

✅ Upload bulk resumes (PDF, DOCX, TXT)
✅ AI analyzes skills, experience, red flags
✅ Ranks candidates with detailed scores
✅ Shows matched/missing skills
✅ Detects job hopping, gaps, issues
✅ Culture fit analysis
✅ Export to CSV, Excel, PDF, ATS JSON

---

💡 Business Value

• Time Saved: 8-10 hours → 2 minutes per role
• Consistency: No human bias or fatigue
• Insights: Red flags, culture fit, detailed breakdown
• ROI: $240-400 saved per position

---