🧭 Life Compass — AI-Powered Career Guidance

Discover your career path. Get personalized recommendations. Build your learning roadmap.

Life Compass is a full-stack web application that helps students and graduates navigate their career journey using AI. Answer a few questions about your interests and education, get career recommendations powered by OpenAI, and generate a step-by-step learning roadmap tailored to your goals.

---

✨ Features

• Career Assessment — Multi-step guided quiz covering location preference, career category, education level, and personal interests
• AI Career Recommendations — OpenAI-powered suggestions with match percentages based on your profile
• Learning Roadmap Generator — Personalized week-by-week learning paths with tools, projects, courses, and certifications
• Roadmap History — Save, view, and delete your previously generated roadmaps
• Authentication — JWT-based login/signup with password reset via OTP email
• 12 Career Categories — From Engineering & Tech to Arts, Law, Sports, and more (India + International)

---

🛠️ Tech Stack

Layer	Technology
Frontend	React (Vite), React Router, Axios, Lucide Icons
Backend	Python, Flask, Flask-JWT-Extended, Flask-SQLAlchemy
Database	SQLite
AI	OpenAI GPT-3.5 Turbo
Auth	JWT + bcrypt password hashing
Email	SMTP (Gmail) for OTP-based password reset

---

🚀 Getting Started

Prerequisites

• Node.js (v18+)
• Python 3.9+
• An OpenAI API key
• A Gmail account (for password reset emails)

---

Backend Setup

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

Create a .env file in the backend/ directory:

OPENAI_API_KEY=your_openai_api_key
JWT_SECRET_KEY=your_jwt_secret_key
SENDER_EMAIL=your_gmail@gmail.com
SENDER_EMAIL_PASSWORD=your_gmail_app_password

Note: Use a Gmail App Password, not your regular Gmail password.

Start the backend:

python app.py

The API runs at http://localhost:5000.

---

Frontend Setup

cd frontend
npm install
npm run dev

The app runs at http://localhost:5173.

---

📁 Project Structure

career_guidance_site/
├── backend/
│   ├── app.py              # Flask app — all routes and models
│   └── .env                # Environment variables (not committed)
│
└── frontend/
    └── src/
        ├── components/
        │   ├── assessment/     # Multi-step career assessment flow
        │   ├── roadmap/        # Roadmap generator + history
        │   ├── Navbar.jsx
        │   ├── ForgotPassword.tsx
        │   └── ResetPassword.tsx
        ├── pages/
        │   ├── Home.jsx
        │   ├── Login.jsx
        │   ├── Signup.jsx
        │   └── Purpose.jsx
        └── App.jsx

---

🔌 API Endpoints

Method	Endpoint	Description	Auth
POST	/auth/register	Register a new user	❌
POST	/auth/login	Login and receive JWT	❌
POST	/auth/forgot-password	Send OTP to email	❌
POST	/auth/reset-password	Reset password with OTP	❌
GET/PUT	/auth/profile	Get or update user profile	✅
GET	/purpose/categories	Get career categories by location	❌
GET	/purpose/questions	Generate assessment questions	❌
POST	/purpose/recommend	Get AI career recommendations	✅
POST	/roadmap/generate	Generate a learning roadmap	✅
GET	/roadmap/history	Get saved roadmaps	✅
DELETE	/roadmap/delete/<id>	Delete a roadmap	✅

---

📸 App Flow

Home → Login/Signup
         ↓
   Find Your Purpose
         ↓
  [1] Select Location (India / International)
  [2] Select Career Category
  [3] Select Education Level
  [4] Answer 5 AI-generated Questions
         ↓
  AI Career Recommendations (with match %)
         ↓
  Generate Learning Roadmap
         ↓
  Visual Flowchart with Checkable Steps

---

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you'd like to change.

---

📄 License

This project is open source and available under the MIT License.