---
language:
- en
license: apache-2.0
pipeline_tag: text-generation
library_name: python
tags:
- education
- learning-path
- curriculum
- career-guidance
- personalization
task_categories:
- text-generation
model-index:
- name: learningpath-gpt
  results: []
---

# Learning Path GPT 🎓🧠

**LearningPathGPT** is an AI system that converts any learning or career goal into a **personalized, step-by-step learning path** complete with **skills, checkpoints, and hands-on projects**.

It is designed for **students, professionals, career switchers, and lifelong learners** who want a clear and structured roadmap to reach their goals.

---

## 🔍 What Problem Does It Solve?

Many learners struggle with:
- Not knowing **what to learn next**
- Overwhelming course choices
- Lack of **clear milestones**
- No project-based validation of skills

LearningPathGPT solves this by generating a **goal-driven curriculum** with:
- Ordered skills
- Weekly checkpoints
- Practical projects

---

## ✨ Key Features

- 🎯 Goal understanding from natural language  
- 🧩 Skill mapping using structured taxonomies  
- 🗺️ Curriculum planning with clear ordering  
- ✅ Checkpoints & milestones  
- 🛠️ Project-based learning suggestions  
- 🤗 Hugging Face–ready (`text-generation`)  
- 🎛️ Gradio demo included  
- 🧪 Core logic covered with tests  

---

## 📂 Project Structure

```
learningpath-gpt/
├── config/
├── data/
├── src/
├── training/
├── pipelines/
├── scripts/
├── tests/
├── notebooks/
├── app.py
├── README.md
├── model_card.md
├── requirements.txt
└── LICENSE
```

---

## ⚙️ Installation

```bash
pip install -r requirements.txt
```

---

## 🚀 Quick Usage

```python
from src.inference import LearningPathPipeline

pipeline = LearningPathPipeline()

result = pipeline("Become a data scientist")
print(result)
```

---

## 🎛️ Gradio Demo

Run locally:

```bash
python app.py
```

---

## 🧠 How It Works

1. **Goal Parsing** – Understands user intent  
2. **Skill Mapping** – Maps goals to required skills  
3. **Curriculum Planning** – Orders skills logically  
4. **Checkpoint Generation** – Adds progress milestones  
5. **Project Generation** – Suggests hands-on practice