An intelligent career guidance platform that leverages AI and Machine Learning to help users explore career paths, build professional resumes, and receive personalized job recommendations.
- AI Resume Builder - Generate professional resumes with AI-enhanced descriptions
- Career Path Analysis - Get personalized career trajectory recommendations
- Job Recommendations - ML-powered job matching based on your skills
- Skill Gap Analysis - Identify skills to learn for career advancement
- Salary Predictions - ML model predictions based on skillset
- Learning Roadmaps - Curated resources to develop new skills
| Layer | Technology |
|---|---|
| Frontend | React 18, Vite, TailwindCSS, React Router |
| Backend | Python, Flask, Flask-CORS |
| AI/ML | Google Gemini API, scikit-learn, pandas |
| Resume Generation | ReportLab (PDF), python-docx |
CareerPath/
├── backend/
│ ├── app/services/ # Core business logic
│ ├── data/ # Job databases & resources
│ ├── models/ # Trained ML models (.pkl)
│ ├── scripts/ # Data processing scripts
│ ├── main.py # Flask application entry
│ └── requirements.txt
├── frontend/
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ ├── pages/ # Route pages
│ │ ├── services/ # API client
│ │ └── context/ # React context providers
│ └── vite.config.js
└── README.md
- Python 3.10+
- Node.js 18+
- npm or yarn
cd backend
# Create virtual environment
python -m venv venv
# Activate virtual environment
# Windows:
.\venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Configure environment
cp .env.example .env
# Edit .env with your API keys
# Start the server
python main.pyThe backend will start on http://localhost:5000
cd frontend
# Install dependencies
npm install
# Start development server
npm run devThe frontend will start on http://localhost:3000
Create a .env file in the backend/ directory:
| Variable | Description | Required |
|---|---|---|
GEMINI_API_KEY |
Google Gemini API key | Yes |
AI_PROVIDER |
gemini |
Yes |
FLASK_DEBUG |
Enable debug mode | No |
PORT |
Server port (default: 5000) | No |
| Endpoint | Method | Description |
|---|---|---|
/api/health |
GET | Health check |
/api/resume/generate |
POST | Generate resume |
/api/resume/download |
POST | Download resume as PDF |
/api/jobs/recommend |
POST | Get job recommendations |
/api/skills/analyze |
POST | Analyze skill gaps |
/api/career/path |
POST | Get career path suggestions |
/api/ml/predict-salary |
POST | Predict salary based on skills |
/api/ml/predict-career |
POST | Predict career category |
Open two terminals:
Terminal 1 - Backend:
cd backend && python main.pyTerminal 2 - Frontend:
cd frontend && npm run dev