README.md

---
title: CareerForge (Group 3)
emoji: 🧭
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.41.1
app_file: app.py
pinned: true
---

# CareerForge — Resume & Interview Coach

A lightweight hackathon prototype that:
- Accepts a Job Description + Resume
- Shows a simple JD↔Resume keyword match score
- Generates tailored resume improvements
- Drafts a customized cover letter
- Runs a 5-question mock interview with sample answers + tips
- Includes a short Bias & Fairness reflection

## 🚀 Run in Hugging Face (Recommended)
1. Create a new **Space** → Framework **Gradio**.
2. Upload: `app.py`, `requirements.txt`, `README.md`.
3. Go to **Settings → Variables and secrets** and add `OPENAI_API_KEY`.
4. Click **Restart this Space**.

> No key? It still works in **Mock Mode** so you can demo end-to-end.

## 🖥️ Run Locally
```bash
pip install -r requirements.txt
python app.py