Skip to content

Latest commit

Β 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ LearnPath AI

Adaptive Career Intelligence for Personalized Learning

LearnPath AI is an AI-powered career intelligence platform that transforms a learner's career goal, current skills, available learning time, and learning evidence into a personalized, adaptive and explainable learning roadmap.

Instead of simply recommending courses, LearnPath AI answers the more important question:

"What should I learn next to become job-ready for my target role?"

The platform continuously analyzes the learner's current state against the requirements of their target career, identifies skill gaps and prerequisites, and recommends the next best learning action.


πŸ“Œ Overview

Today's learners have access to thousands of:

  • Courses
  • Tutorials
  • Certifications
  • Projects
  • Documentation
  • Practice platforms
  • Learning resources

However, having more resources does not necessarily make learning easier.

The major challenge is deciding:

  • What should I learn first?
  • Which skill is actually important for my target role?
  • Do I have the prerequisites for this skill?
  • What should I do if I am missing a prerequisite?
  • How much should I learn every day?
  • Am I actually progressing toward my career goal?
  • What should be my next action?

LearnPath AI acts as an intelligent decision layer between the learner and the overwhelming amount of available learning content.


🧩 Problem Statement

Most existing learning platforms follow a content-first approach:

Search for a Course
        ↓
Choose a Course
        ↓
Learn Topics
        ↓
Complete Content
        ↓
Hope the Skills Are Relevant

 # This creates several problems:

1. Information Overload

Learners are presented with hundreds of courses and resources without knowing which one is actually relevant to their goal.

2. No Personalized Skill Gap Analysis

Generic learning paths do not always consider what the learner already knows.

3. Missing Prerequisite Awareness

Learners may start advanced topics without having the foundational skills required to understand them.

4. No Clear Next Action

Even after identifying a skill gap, learners often do not know what they should do next.

5. Static Learning Paths

# πŸ’‘ Our Solution

LearnPath AI is an **AI-powered, career-first learning platform** that helps learners understand exactly what they need to learn, in what order, and what they should do next to move closer to their target career.

Instead of overwhelming learners with a large list of courses and resources, LearnPath AI analyzes the learner's **career goal, current skills, learning evidence, prerequisites, and available learning time** to generate a personalized and adaptive learning journey.

### πŸ”Ή How Our Solution Works

```text
🎯 Career Goal
      ↓
πŸ“‹ Target Role Requirements
      ↓
🧠 Current Skills & Learning Evidence
      ↓
πŸ” Skill Gap Analysis
      ↓
πŸ”— Prerequisite Detection
      ↓
⭐ Priority Evaluation
      ↓
🎯 Next Best Action
      ↓
πŸ“š Learn / Practice / Build
      ↓
πŸ“Š New Learning Evidence
      ↓
πŸ”„ Adaptive Learning Path

Traditional roadmaps are usually fixed and do not adapt when the learner gains new skills or provides new evidence.

6. Career Disconnect

Learning progress is often measured in terms of courses completed rather than actual readiness for a target career role.

# 🧠 Our Approach

LearnPath AI follows a **personalized, evidence-driven, and adaptive approach** to guide learners toward their target careers.

Instead of generating a fixed roadmap, the system continuously evaluates the learner's current state and determines the most relevant next step.

### πŸ”Ή Approach Flow

```text
🎯 Define Career Goal
        ↓
🧠 Analyze Current Skills
        ↓
πŸ“Š Identify Skill Gaps
        ↓
πŸ”— Check Skill Prerequisites
        ↓
⏱️ Consider Available Learning Time
        ↓
⭐ Prioritize the Most Important Gap
        ↓
🎯 Recommend Next Best Action
        ↓
πŸ“š Learn / Practice / Build
        ↓
πŸ“ˆ Generate New Evidence
        ↓
πŸ”„ Update & Adapt the Learning Path

# 🧠 Core Intelligence

LearnPath AI combines multiple intelligence layers to create a personalized and continuously improving learning journey.

### πŸ”Ή 1. 🎯 Career Intelligence

The system starts with the learner's target career and identifies the skills required to move toward that role.

### πŸ”Ή 2. πŸ” Skill Gap Intelligence

The learner's current skills are compared with the required skills to identify missing and weak areas.

### πŸ”Ή 3. πŸ”— Prerequisite Intelligence

The system understands dependencies between skills and ensures that foundational skills are considered before advanced ones.

### πŸ”Ή 4. ⭐ Next Best Action Engine

Instead of showing a long list of recommendations, LearnPath AI prioritizes the most valuable action the learner should take next.

### πŸ”Ή 5. πŸ“Š Evidence-Based Intelligence

Learning progress is supported by evidence such as assessments, projects, practice and completed learning activities.

### πŸ”Ή 6. ⏱️ Time-Aware Intelligence

The learning path considers the learner's available time so that recommendations remain realistic and achievable.

### πŸ”Ή 7. πŸ”„ Adaptive Intelligence

Whenever the learner gains new skills or provides new evidence, the system can update the learner state and adapt the recommended learning path.

### πŸ”Ή 8. πŸ’¬ Explainable Recommendations

LearnPath AI focuses on explaining **why** an action is recommended, helping learners understand the reasoning behind their learning journey.

```text
Career Goal
     +
Current Skills
     +
Learning Evidence
     +
Prerequisites
     +
Time Availability
          ↓
   🧠 Intelligence Layer
          ↓
   Skill Gap Analysis
          ↓
   Priority Evaluation
          ↓
   ⭐ Next Best Action
          ↓
   πŸ”„ Adaptive Roadmap

# ✨ Key Features

### 🎯 Personalized Career Roadmap
Generate a learning path based on the learner's target career, current skills, skill gaps, and available learning time.

### πŸ” Skill Gap Analysis
Identify the skills the learner already has, the skills required for the target role, and the gaps that need to be addressed.

### πŸ”— Prerequisite-Aware Learning
Understand dependencies between skills and recommend foundational concepts before advanced topics.

### ⭐ Next Best Action
Prioritize the **single most valuable next learning action** instead of overwhelming the learner with a long list of options.

### πŸ”„ Adaptive Learning Path
Automatically adapt the roadmap as the learner completes activities, improves skills, or provides new learning evidence.

### πŸ“Š Career Readiness Tracking
Track the learner's progress toward their target career through skill coverage and demonstrated learning evidence.

### 🧠 Interactive Skill Graph
Visualize relationships and dependencies between different skills to make the learning sequence easier to understand.

### πŸ€– AI Coach
Interact with an AI-powered coach to ask questions about the roadmap, skills, recommendations, and career progress.

### πŸ“„ Resume-Based Skill Analysis
Extract relevant information from an uploaded resume and use it to understand the learner's existing skill profile.

### ⏱️ Time-Aware Planning
Consider the learner's available daily learning time while generating realistic learning recommendations.

### πŸ“š Project-Based Learning
Connect learning with practical projects so learners can build evidence of their skills instead of relying only on course completion.

### πŸ’¬ Explainable Recommendations
Show learners **why** a particular skill or action is being recommended.

### πŸ“ˆ Progress & Learning Insights
Provide a clear view of current progress, skill development, learning activity, and career readiness.

# πŸ—οΈ System Architecture

LearnPath AI follows a modular full-stack architecture where the frontend, backend, intelligence layer, and data layer work together to create a personalized learning experience.

### πŸ”Ή High-Level Architecture

```text
                         πŸ‘€ LEARNER
                             β”‚
                             β–Ό
                  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                  β”‚   React + Vite UI   β”‚
                  β”‚                     β”‚
                  β”‚ β€’ Dashboard         β”‚
                  β”‚ β€’ Learning Path     β”‚
                  β”‚ β€’ Skill Intelligenceβ”‚
                  β”‚ β€’ AI Coach          β”‚
                  β”‚ β€’ Profile           β”‚
                  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                             β”‚
                        REST API
                             β”‚
                             β–Ό
                  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                  β”‚      FastAPI        β”‚
                  β”‚      Backend        β”‚
                  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                             β”‚
            β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
            β”‚                β”‚                β”‚
            β–Ό                β–Ό                β–Ό
     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
     β”‚ Skill & Roleβ”‚  β”‚Recommendationβ”‚  β”‚   Adaptive  β”‚
     β”‚   Engine    β”‚  β”‚    Engine    β”‚  β”‚    Engine   β”‚
     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
            β”‚                β”‚                β”‚
            β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                             β”‚
                             β–Ό
                  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                  β”‚    AI Service       β”‚
                  β”‚  Optional LLM Layer β”‚
                  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                             β”‚
                             β–Ό
                  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                  β”‚   SQLite Database   β”‚
                  β”‚   Learner State &   β”‚
                  β”‚   Application Data  β”‚
                  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

# πŸ€– AI & Recommendation Architecture

LearnPath AI combines rule-based intelligence with AI-assisted capabilities to provide personalized and explainable learning recommendations.

### πŸ”Ή Recommendation Flow

```text
🎯 Target Career
       ↓
πŸ“‹ Required Skills
       ↓
πŸ‘€ Learner Profile
       ↓
🧠 Current Skills & Evidence
       ↓
πŸ” Skill Gap Analysis
       ↓
πŸ”— Prerequisite Check
       ↓
⏱️ Time & Learning Constraints
       ↓
πŸ“Š Priority Evaluation
       ↓
⭐ Next Best Action
       ↓
πŸ“š Personalized Learning Path

# πŸ”„ Learning Intelligence Pipeline

LearnPath AI continuously evaluates the learner's progress and converts new learning evidence into updated recommendations.

### πŸ”Ή End-to-End Learning Cycle

```text
🎯 1. Define Career Goal
              ↓
πŸ‘€ 2. Build Learner Profile
              ↓
🧠 3. Analyze Current Skills
              ↓
πŸ“‹ 4. Identify Target Role Skills
              ↓
πŸ” 5. Calculate Skill Gaps
              ↓
πŸ”— 6. Check Prerequisites
              ↓
πŸ“Š 7. Prioritize Skill Gaps
              ↓
⭐ 8. Generate Next Best Action
              ↓
πŸ“š 9. Learn / Practice / Build
              ↓
πŸ§ͺ 10. Assessment & Evidence
              ↓
πŸ“ˆ 11. Update Learner State
              ↓
πŸ”„ 12. Adapt Learning Path
              ↓
⭐ 13. Generate the Next Best Action

# πŸ› οΈ Tech Stack

LearnPath AI is built using a modern full-stack architecture combining a responsive frontend, FastAPI backend, intelligent recommendation services, and lightweight data persistence.

### 🎨 Frontend

- **React** β€” Component-based UI development
- **Vite** β€” Fast frontend development and production builds
- **JavaScript** β€” Application logic
- **CSS** β€” Responsive and interactive UI
- **Lucide React** β€” Modern interface icons
- **Recharts** β€” Progress and career-readiness visualizations

### βš™οΈ Backend

- **Python** β€” Core backend and intelligence logic
- **FastAPI** β€” High-performance REST API framework
- **Uvicorn** β€” ASGI server
- **Pydantic** β€” Data validation and structured API schemas
- **SQLite** β€” Lightweight persistent database

### 🧠 AI & Intelligence

- **OpenAI API** β€” AI-assisted coaching and intelligent interactions
- **scikit-learn** β€” Machine-learning utilities and data processing
- **Custom Recommendation Logic** β€” Skill-gap and next-best-action prioritization
- **Adaptive Learning Engine** β€” Updates recommendations based on learner progress
- **Prerequisite Graph** β€” Represents dependencies between skills

### πŸ“„ Data Processing

- **PyPDF** β€” Resume/PDF text extraction
- **Structured Skill & Role Catalog** β€” Career and skill intelligence
- **Evidence-based learner state** β€” Tracks demonstrated learning progress

### πŸ§ͺ Testing

- **Pytest** β€” Backend testing and validation

### πŸš€ Development & Deployment

- **Git & GitHub** β€” Version control and collaboration
- **VS Code** β€” Development environment
- **Docker** β€” Containerization support
- **Render** β€” Deployment support
- **REST APIs** β€” Frontend-backend communication

# πŸ“ Project Structure

```text
LearnPath-AI/
β”‚
β”œβ”€β”€ backend/
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ __init__.py
β”‚   β”‚   β”œβ”€β”€ main.py
β”‚   β”‚   β”œβ”€β”€ db.py
β”‚   β”‚   β”œβ”€β”€ schemas.py
β”‚   β”‚   β”‚
β”‚   β”‚   β”œβ”€β”€ data/
β”‚   β”‚   β”‚   β”œβ”€β”€ __init__.py
β”‚   β”‚   β”‚   └── catalog.py
β”‚   β”‚   β”‚
β”‚   β”‚   └── services/
β”‚   β”‚       β”œβ”€β”€ __init__.py
β”‚   β”‚       β”œβ”€β”€ adaptive.py
β”‚   β”‚       β”œβ”€β”€ ai_service.py
β”‚   β”‚       β”œβ”€β”€ goal_parser.py
β”‚   β”‚       └── recommender.py
β”‚   β”‚
β”‚   β”œβ”€β”€ requirements.txt
β”‚   └── .env.example
β”‚
β”œβ”€β”€ frontend/
β”‚   β”œβ”€β”€ public/
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ pages/
β”‚   β”‚   β”œβ”€β”€ services/
β”‚   β”‚   β”œβ”€β”€ App.jsx
β”‚   β”‚   └── main.jsx
β”‚   β”‚
β”‚   β”œβ”€β”€ package.json
β”‚   └── vite.config.js
β”‚
β”œβ”€β”€ .gitignore
β”œβ”€β”€ render.yaml
└── README.md

# βš™οΈ Installation & Local Setup

Follow the steps below to run LearnPath AI locally on your system.

## πŸ“‹ Prerequisites

Make sure the following are installed:

- Python 3.10+
- Node.js 18+
- npm
- Git
- VS Code

Check the installed versions:

```bash
python --version
node --version
npm --version
git --version

# πŸ”Œ API & Backend Endpoints

LearnPath AI uses a **FastAPI-based backend** to connect the frontend with the learning intelligence, recommendation logic, learner data, and AI services.

The backend exposes REST APIs that allow the frontend to send learner information and receive personalized learning insights.

## πŸ“‘ API Flow

```text
React Frontend
      ↓
   REST API
      ↓
FastAPI Backend
      ↓
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Learner Profile              β”‚
β”‚ Career & Goal Analysis       β”‚
β”‚ Skill Gap Analysis           β”‚
β”‚ Recommendation Engine        β”‚
β”‚ Adaptive Learning Engine     β”‚
β”‚ AI Services                  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
               ↓
       Personalized Response
               ↓
        React Frontend

# ☁️ Deployment

LearnPath AI is designed with a separate frontend and backend, allowing both services to be deployed independently.

## πŸš€ Deployment Architecture

```text
                    🌐 USER
                       β”‚
                       β–Ό
              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
              β”‚    Frontend     β”‚
              β”‚ React + Vite    β”‚
              β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                       β”‚
                  HTTPS / REST
                       β”‚
                       β–Ό
              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
              β”‚     Backend     β”‚
              β”‚    FastAPI      β”‚
              β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                       β”‚
              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”
              β–Ό                 β–Ό
       🧠 AI Services      πŸ—„οΈ Application Data

# πŸ§ͺ Testing & Validation

LearnPath AI is tested across its frontend, backend, API layer, recommendation logic, and user workflows to ensure reliable and consistent behavior.

## πŸ”Ή Testing Strategy

```text
Frontend Testing
       ↓
API Testing
       ↓
Backend Testing
       ↓
Recommendation Testing
       ↓
End-to-End Testing
       ↓
Production Validation

# 🌟 Unique Value Proposition

LearnPath AI is designed to go beyond traditional course recommendation platforms by focusing on **career outcomes, skill gaps, prerequisites, learning evidence, and the next best action**.

### πŸ”Ή What Makes LearnPath AI Stand Out?

| Challenge | LearnPath AI Approach |
|---|---|
| Too many courses and resources | 🎯 Prioritized learning actions |
| Generic learning paths | πŸ‘€ Personalized roadmap |
| Learners skip fundamentals | πŸ”— Prerequisite-aware recommendations |
| Static roadmaps | πŸ”„ Adaptive learning paths |
| Course completion β‰  skill mastery | πŸ§ͺ Evidence-driven progress |
| Learners don't know what to do next | ⭐ Next Best Action |
| AI recommendations can feel random | πŸ’¬ Explainable recommendations |
| Limited time for learning | ⏱️ Time-aware planning |
| Learning disconnected from careers | 🎯 Career-oriented skill mapping |

### πŸš€ Our Core Differentiator

Most platforms focus on:

```text
Content β†’ Course β†’ Completion

# πŸš€ Future Scope

LearnPath AI can be further enhanced to become a complete **AI-powered career intelligence ecosystem**.

### πŸ”Ή Planned Enhancements

- πŸ€– **Advanced AI Career Planning** β€” Generate personalized long-term career strategies based on learner goals and industry requirements.
- πŸ“„ **Resume Intelligence** β€” Automatically extract skills, projects, and experience from resumes.
- πŸ’Ό **Job Description Matching** β€” Compare learner skills with real-world job requirements and identify missing skills.
- πŸ“ˆ **Real-Time Skill Demand Analysis** β€” Prioritize skills based on changing industry and job-market demand.
- πŸ§ͺ **Adaptive Skill Assessments** β€” Generate assessments based on individual strengths and weaknesses.
- πŸ—οΈ **Project Recommendations** β€” Recommend practical projects that help learners build evidence for specific skills.
- 🧠 **Advanced Skill Knowledge Graph** β€” Expand the skill graph with deeper relationships between technologies, concepts, and career roles.
- πŸ‘¨β€πŸ« **Mentor Integration** β€” Enable mentors to review learner progress and validate learning evidence.
- πŸ“Š **Advanced Career Analytics** β€” Provide insights into skill growth, readiness trajectory, learning efficiency, and career progress.
- 🌐 **Multi-Platform Support** β€” Extend LearnPath AI to mobile and other learning environments.

### 🎯 Long-Term Vision

Our vision is to evolve LearnPath AI from a personalized learning-path generator into a **continuous career intelligence assistant** that helps learners make better decisions throughout their entire career journey.

# πŸŽ₯ Demo

A complete demonstration of LearnPath AI showcases how the platform transforms a learner's career goal into an adaptive, personalized learning journey.

### πŸ”Ή Demo Flow

```text
πŸ‘€ Learner Profile
        ↓
🎯 Select Career Goal
        ↓
🧠 Analyze Current Skills
        ↓
πŸ” Identify Skill Gaps
        ↓
πŸ”— Check Prerequisites
        ↓
⭐ Generate Next Best Action
        ↓
πŸ“š Follow Learning Path
        ↓
πŸ“Š Track Progress
        ↓
πŸ€– Interact with AI Coach
        ↓
πŸ”„ Adapt Learning Path

# 🀝 Contributing

Contributions, suggestions, and improvements are welcome.

To contribute to LearnPath AI:

1. Fork the repository.
2. Create a new feature branch:

```bash
git checkout -b feature/your-feature

## 🌐 Live Demo

πŸš€ **Live Application:** https://learnpath-ai-1-7s0g.onrender.com

πŸ”— **Backend API:** https://learnpath-ai-0km2.onrender.com

πŸ“¦ **Source Code:** https://github.com/anshikajain17/LearnPath-AI

## πŸ‘©β€πŸ’» Team

Built with ❀️ for building a more intelligent and personalized learning journey.

---

## πŸ“„ License

This project is developed for educational, hackathon, and demonstration purposes.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages