Skip to content

Simran-775/RoadmapX

Repository files navigation

🚀 RoadmapX — AI Career Development Roadmap Generator

An intelligent full-stack web application that generates personalized, quarter-wise career development roadmaps using Google Gemini AI.

Built as part of a Hackathon by Team AI Innovators (Team ID: T078).

🎯 Problem It Solves

Generic career advice doesn't work for everyone. RoadmapX analyzes your current skills, experience, and target role — then generates a precise, actionable development plan tailored specifically to you.

✨ Features

  • 📋 Input your skills, projects, experience and target role
  • 📄 Optional PDF resume upload for richer analysis
  • 🤖 Google Gemini AI generates personalized quarter-wise roadmap
  • 📊 Identifies skill gaps between current profile and target role
  • 💡 Suggests projects, learning paths and leadership improvements
  • 🔔 Real-time notifications with react-toastify
  • 📱 Clean responsive React UI

🛠️ Tech Stack

Frontend: React JavaScript CSS3

Backend: Python FastAPI

AI: Google Gemini (gemini-2.5-flash-preview-05-20)
Libraries: axios · react-toastify · uvicorn

⚙️ How It Works

User fills profile form (skills, target role, projects, experience)
              ↓
React frontend sends POST request to FastAPI backend
              ↓
Backend feeds profile to Google Gemini LLM
              ↓
Gemini analyzes skill gaps + generates quarter-wise roadmap
              ↓
Roadmap displayed on frontend in structured format

🚀 How to Run

Backend

cd backend
pip install -r requirements.txt
uvicorn app:app --reload
# Runs on http://localhost:8000

Frontend

cd frontend
npm install
npm start
# Runs on http://localhost:3000

Add your Google Gemini API key to the backend .env file before running.

📁 Project Structure

RoadmapX/
├── frontend/        # React application
├── backend/         # FastAPI server + Gemini integration
└── README.md

👥 Team — AI Innovators (T078)

Member Role
Simranjeet Kaur Full Stack — React Frontend + FastAPI Backend Integration
Jasleen Kaur Backend Development (FastAPI)
Kritika API Key Generation and Usage
Jasreet Kaur Presentation
Ankush Garg Research

📬 Contact

Made with 💙 by Simranjeet Kaur


About

AI career roadmap generator using Google Gemini LLM — React + FastAPI hackathon project

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages