PrepAI — AI-Powered Interview Prep

Practice job interviews with AI-generated questions, instant feedback, score tracking, and study resources — all tailored to any job description you paste.

---

What it does

1. Paste a job description — the app generates 7 role-specific interview questions (behavioral, technical, situational)
2. Answer each question — get an instant score out of 10, verdict, strengths, areas to improve, and a curated study resource
3. Retry any question — re-answer to improve your score; the AI compares attempts and tracks your progress
4. Review past sessions — full history with score timelines showing improvement across attempts

---

Tech Stack

Layer	Technology
Backend	FastAPI (Python)
LLM	Groq API — llama-3.3-70b-versatile (free tier)
Database	SQLite (local) / PostgreSQL (production)
Auth	JWT + bcrypt
Frontend	React + Vite
Deployment	Render (backend) + Vercel (frontend)

---

Features

• 🔐 Auth — sign up / sign in with JWT-based authentication
• 🎯 Role-specific questions — 7 questions generated from any job description
• 📊 Instant scoring — every answer scored 1–10 with verdict (Strong / Good / Needs Work / Weak)
• 🔄 Retry & improve — re-attempt any question and see score delta (+2, -1)
• 📈 Score timeline — visual history of all attempts per question
• 📚 Study resources — a curated link recommended after every answer
• 🏷️ Session titles — AI-generated short title for each session (e.g. "SWE Intern", "Data Analyst")
• 🕓 Session history — review all past sessions, retry questions directly from history

---

Local Setup

Prerequisites

• Python 3.10+
• Node.js 18+
• Free Groq API key

1. Clone the repo

git clone https://github.com/your-username/prepai.git
cd PrepAI

2. Backend

cd back_end
python -m venv env
source env/bin/activate        # Windows: env\Scripts\activate
pip install -r requirements.txt

Create a .env file in back_end/:

GROQ_API_KEY=your_groq_api_key_here
JWT_SECRET=any_long_random_string_here

Start the server:

uvicorn main:app --reload
# API runs at http://localhost:8000
# Swagger docs at http://localhost:8000/docs

3. Frontend

cd front_end
npm install

Create a .env file in front_end/:

VITE_API_URL=http://127.0.0.1:8000

Start the dev server:

npm run dev
# App runs at http://localhost:5173

---

API Reference

Method	Endpoint	Auth	Description
POST	/register	❌	Create account
POST	/login	❌	Sign in, returns JWT
POST	/generate-questions	✅	Generate 7 questions from JD
POST	/evaluate-answer	✅	Score an answer, return feedback
GET	/sessions	✅	List all sessions for current user
GET	/sessions/{id}/results	✅	Full results for a session
GET	/health	❌	Health check

---

Project Structure

prepai/
├── back_end/
│   ├── main.py              # FastAPI app — all routes and logic
│   ├── requirements.txt
│   ├── .env                 # GROQ_API_KEY, JWT_SECRET (not committed)
│   └── sessions.db          # SQLite DB, auto-created on first run
│
└── front_end/
    ├── src/
    │   ├── App.jsx           # Entire React app (auth, session, history)
    │   └── main.jsx
    ├── index.html
    ├── .env                  # VITE_API_URL (not committed)
    ├── package.json
    └── vite.config.js

---

Environment Variables

Variable	Where	Description
GROQ_API_KEY	back_end/.env	Free key from console.groq.com
JWT_SECRET	back_end/.env	Any long random string for signing tokens
VITE_API_URL	front_end/.env	Backend URL (default: http://127.0.0.1:8000)

---

Screenshots

---