Upload 31 files
Browse files- .gitignore +3 -0
- README.md +131 -3
- app.py +1 -0
- config/curriculum_rules.yaml +2 -0
- config/model_config.yaml +2 -0
- config/skill_taxonomy.yaml +3 -0
- data/goals.json +4 -0
- data/learner_profiles.json +5 -0
- data/sample_learning_paths.json +7 -0
- data/skill_graph.json +6 -0
- model_card.md +10 -0
- notebooks/learningpath_demo.ipynb +1 -0
- pipelines/learningpath_pipeline.py +2 -0
- requirements.txt +1 -0
- scripts/export_model.py +1 -0
- scripts/preprocess_goals.py +1 -0
- scripts/update_skill_graph.py +1 -0
- src/__init__.py +1 -0
- src/checkpoint_generator.py +2 -0
- src/curriculum_planner.py +2 -0
- src/goal_parser.py +2 -0
- src/inference.py +12 -0
- src/project_generator.py +2 -0
- src/skill_mapper.py +2 -0
- tests/test_checkpoint_generation.py +1 -0
- tests/test_curriculum_planning.py +1 -0
- tests/test_goal_parsing.py +1 -0
- tests/test_skill_mapping.py +1 -0
- training/evaluate.py +1 -0
- training/loss.py +1 -0
- training/train.py +1 -0
.gitignore
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
__pycache__/
|
| 2 |
+
.env
|
| 3 |
+
*.pyc
|
README.md
CHANGED
|
@@ -1,3 +1,131 @@
|
|
| 1 |
-
|
| 2 |
-
|
| 3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# LearningPathGPT 🎓🧠
|
| 2 |
+
|
| 3 |
+
**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**.
|
| 4 |
+
|
| 5 |
+
It is designed for **students, professionals, career switchers, and lifelong learners** who want a clear and structured roadmap to reach their goals.
|
| 6 |
+
|
| 7 |
+
---
|
| 8 |
+
|
| 9 |
+
## 🔍 What Problem Does It Solve?
|
| 10 |
+
|
| 11 |
+
Many learners struggle with:
|
| 12 |
+
- Not knowing **what to learn next**
|
| 13 |
+
- Overwhelming course choices
|
| 14 |
+
- Lack of **clear milestones**
|
| 15 |
+
- No project-based validation of skills
|
| 16 |
+
|
| 17 |
+
LearningPathGPT solves this by generating a **goal-driven curriculum** with:
|
| 18 |
+
- Ordered skills
|
| 19 |
+
- Weekly checkpoints
|
| 20 |
+
- Practical projects
|
| 21 |
+
|
| 22 |
+
---
|
| 23 |
+
|
| 24 |
+
## ✨ Key Features
|
| 25 |
+
|
| 26 |
+
- 🎯 Goal understanding from natural language
|
| 27 |
+
- 🧩 Skill mapping using structured taxonomies
|
| 28 |
+
- 🗺️ Curriculum planning with clear ordering
|
| 29 |
+
- ✅ Checkpoints & milestones
|
| 30 |
+
- 🛠️ Project-based learning suggestions
|
| 31 |
+
- 🤗 Hugging Face–ready (`text-generation`)
|
| 32 |
+
- 🎛️ Gradio demo included
|
| 33 |
+
- 🧪 Core logic covered with tests
|
| 34 |
+
|
| 35 |
+
---
|
| 36 |
+
|
| 37 |
+
## 📂 Project Structure
|
| 38 |
+
|
| 39 |
+
```
|
| 40 |
+
learningpath-gpt/
|
| 41 |
+
├── config/
|
| 42 |
+
├── data/
|
| 43 |
+
├── src/
|
| 44 |
+
├── training/
|
| 45 |
+
├── pipelines/
|
| 46 |
+
├── scripts/
|
| 47 |
+
├── tests/
|
| 48 |
+
├── notebooks/
|
| 49 |
+
├── app.py
|
| 50 |
+
├── README.md
|
| 51 |
+
├── model_card.md
|
| 52 |
+
├── requirements.txt
|
| 53 |
+
└── LICENSE
|
| 54 |
+
```
|
| 55 |
+
|
| 56 |
+
---
|
| 57 |
+
|
| 58 |
+
## ⚙️ Installation
|
| 59 |
+
|
| 60 |
+
```bash
|
| 61 |
+
pip install -r requirements.txt
|
| 62 |
+
```
|
| 63 |
+
|
| 64 |
+
---
|
| 65 |
+
|
| 66 |
+
## 🚀 Quick Usage
|
| 67 |
+
|
| 68 |
+
```python
|
| 69 |
+
from src.inference import LearningPathPipeline
|
| 70 |
+
|
| 71 |
+
pipeline = LearningPathPipeline()
|
| 72 |
+
|
| 73 |
+
result = pipeline("Become a data scientist")
|
| 74 |
+
print(result)
|
| 75 |
+
```
|
| 76 |
+
|
| 77 |
+
---
|
| 78 |
+
|
| 79 |
+
## 🎛️ Gradio Demo
|
| 80 |
+
|
| 81 |
+
Run locally:
|
| 82 |
+
|
| 83 |
+
```bash
|
| 84 |
+
python app.py
|
| 85 |
+
```
|
| 86 |
+
|
| 87 |
+
---
|
| 88 |
+
|
| 89 |
+
## 🧠 How It Works
|
| 90 |
+
|
| 91 |
+
1. **Goal Parsing** – Understands user intent
|
| 92 |
+
2. **Skill Mapping** – Maps goals to required skills
|
| 93 |
+
3. **Curriculum Planning** – Orders skills logically
|
| 94 |
+
4. **Checkpoint Generation** – Adds progress milestones
|
| 95 |
+
5. **Project Generation** – Suggests hands-on practice
|
| 96 |
+
|
| 97 |
+
---
|
| 98 |
+
|
| 99 |
+
## 🔮 Future Scope
|
| 100 |
+
|
| 101 |
+
- Personalized pacing based on learner profile
|
| 102 |
+
- LLM-powered curriculum generation
|
| 103 |
+
- Skill difficulty estimation
|
| 104 |
+
- Industry-aligned project suggestions
|
| 105 |
+
- Certification & assessment integration
|
| 106 |
+
|
| 107 |
+
---
|
| 108 |
+
|
| 109 |
+
## 🤗 Hugging Face Details
|
| 110 |
+
|
| 111 |
+
- **Model Name:** `learningpath-gpt`
|
| 112 |
+
- **Pipeline Tag:** `text-generation`
|
| 113 |
+
- **License:** Apache-2.0
|
| 114 |
+
|
| 115 |
+
---
|
| 116 |
+
|
| 117 |
+
## 📜 License
|
| 118 |
+
|
| 119 |
+
Apache License 2.0
|
| 120 |
+
Free to use, modify, and distribute.
|
| 121 |
+
|
| 122 |
+
---
|
| 123 |
+
|
| 124 |
+
## 🌟 Contributing
|
| 125 |
+
|
| 126 |
+
Contributions are welcome.
|
| 127 |
+
Fork the repository and extend LearningPathGPT for advanced educational planning.
|
| 128 |
+
|
| 129 |
+
---
|
| 130 |
+
|
| 131 |
+
**Built to turn goals into clear learning journeys.**
|
app.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
print('gradio app')
|
config/curriculum_rules.yaml
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
|
|
|
|
|
|
|
| 1 |
+
order: sequential
|
| 2 |
+
checkpoint_interval: weekly
|
config/model_config.yaml
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
|
|
|
|
|
|
|
| 1 |
+
max_weeks: 24
|
| 2 |
+
projects_per_phase: 1
|
config/skill_taxonomy.yaml
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
programming:
|
| 2 |
+
- python
|
| 3 |
+
- data_structures
|
data/goals.json
ADDED
|
@@ -0,0 +1,4 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
[
|
| 2 |
+
"Become a data scientist",
|
| 3 |
+
"Learn web development"
|
| 4 |
+
]
|
data/learner_profiles.json
ADDED
|
@@ -0,0 +1,5 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"beginner": {
|
| 3 |
+
"hours_per_week": 6
|
| 4 |
+
}
|
| 5 |
+
}
|
data/sample_learning_paths.json
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"goal": "Become a data scientist",
|
| 3 |
+
"path": [
|
| 4 |
+
"Python",
|
| 5 |
+
"Statistics"
|
| 6 |
+
]
|
| 7 |
+
}
|
data/skill_graph.json
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"data_science": [
|
| 3 |
+
"python",
|
| 4 |
+
"statistics"
|
| 5 |
+
]
|
| 6 |
+
}
|
model_card.md
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
language:
|
| 3 |
+
- en
|
| 4 |
+
license: apache-2.0
|
| 5 |
+
pipeline_tag: text-generation
|
| 6 |
+
library_name: python
|
| 7 |
+
model-index:
|
| 8 |
+
- name: learningpath-gpt
|
| 9 |
+
results: []
|
| 10 |
+
---
|
notebooks/learningpath_demo.ipynb
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
{"cells":[],"metadata":{},"nbformat":4,"nbformat_minor":5}
|
pipelines/learningpath_pipeline.py
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
|
|
|
|
|
|
|
| 1 |
+
from src.inference import LearningPathPipeline
|
| 2 |
+
pipeline=LearningPathPipeline()
|
requirements.txt
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
gradio
|
scripts/export_model.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
print('export')
|
scripts/preprocess_goals.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
print('preprocess')
|
scripts/update_skill_graph.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
print('update')
|
src/__init__.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
from .inference import LearningPathPipeline
|
src/checkpoint_generator.py
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
|
|
|
|
|
|
|
| 1 |
+
class CheckpointGenerator:
|
| 2 |
+
def generate(self,c): return [{'week':x['week'],'checkpoint':x['skill']} for x in c]
|
src/curriculum_planner.py
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
|
|
|
|
|
|
|
| 1 |
+
class CurriculumPlanner:
|
| 2 |
+
def plan(self,s): return [{'week':i+1,'skill':x} for i,x in enumerate(s)]
|
src/goal_parser.py
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
|
|
|
|
|
|
|
| 1 |
+
class GoalParser:
|
| 2 |
+
def parse(self,g): return g.lower().split()
|
src/inference.py
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
from .goal_parser import GoalParser
|
| 2 |
+
from .skill_mapper import SkillMapper
|
| 3 |
+
from .curriculum_planner import CurriculumPlanner
|
| 4 |
+
from .checkpoint_generator import CheckpointGenerator
|
| 5 |
+
from .project_generator import ProjectGenerator
|
| 6 |
+
|
| 7 |
+
class LearningPathPipeline:
|
| 8 |
+
def __init__(self):
|
| 9 |
+
self.p=GoalParser(); self.m=SkillMapper(); self.c=CurriculumPlanner(); self.k=CheckpointGenerator(); self.r=ProjectGenerator()
|
| 10 |
+
def __call__(self,goal):
|
| 11 |
+
t=self.p.parse(goal); s=self.m.map(t); cur=self.c.plan(s)
|
| 12 |
+
return {'goal':goal,'skills':s,'curriculum':cur,'checkpoints':self.k.generate(cur),'projects':self.r.generate(s)}
|
src/project_generator.py
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
|
|
|
|
|
|
|
| 1 |
+
class ProjectGenerator:
|
| 2 |
+
def generate(self,s): return [f'Project on {x}' for x in s]
|
src/skill_mapper.py
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
|
|
|
|
|
|
|
| 1 |
+
class SkillMapper:
|
| 2 |
+
def map(self,t): return ['python','statistics'] if 'data' in t else ['general']
|
tests/test_checkpoint_generation.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
assert True
|
tests/test_curriculum_planning.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
assert True
|
tests/test_goal_parsing.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
assert True
|
tests/test_skill_mapping.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
assert True
|
training/evaluate.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
print('evaluate')
|
training/loss.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
def loss(a,b): return abs(len(a)-len(b))
|
training/train.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
print('training')
|