|
|
--- |
|
|
license: mit |
|
|
base_model: |
|
|
- meta-llama/Llama-3.2-3B-Instruct |
|
|
pipeline_tag: text-generation |
|
|
library_name: adapter-transformers |
|
|
tags: |
|
|
- langgraph |
|
|
- educational |
|
|
- tutor |
|
|
- ai-tutor |
|
|
- adaptive-learning |
|
|
- text-generation |
|
|
- llama3.2 |
|
|
--- |
|
|
# 🤖 Enhanced AI Tutor System using LLaMA-3 and LangGraph |
|
|
|
|
|
[](LICENSE) |
|
|
[](https://python.langgraph.dev/) |
|
|
[](https://huggingface.co/meta-llama/Llama-3.2-3B-Instruct) |
|
|
|
|
|
An **adaptive, feedback-based AI tutor system** built using: |
|
|
|
|
|
- 🧠 Meta's [LLaMA-3.2-3B-Instruct](https://huggingface.co/meta-llama/Llama-3.2-3B-Instruct) |
|
|
- 🔄 [LangGraph](https://github.com/langchain-ai/langgraph) for multi-agent workflow |
|
|
- ⚡ Hugging Face Transformers (4-bit quantization for efficiency) |
|
|
- ✅ PyTorch, BitsandBytes, Accelerate for seamless GPU usage |
|
|
|
|
|
--- |
|
|
|
|
|
## 🎓 What It Does |
|
|
|
|
|
This notebook walks you through a **complete interactive tutor session** that: |
|
|
|
|
|
1. 📚 Asks a question from a topic you choose |
|
|
2. 📝 Evaluates your answer and gives structured feedback |
|
|
3. 🧪 Generates a new practice question |
|
|
4. 📈 Tracks your progress and adapts difficulty |
|
|
|
|
|
It's like having your own AI teacher, personalized to your learning! |
|
|
|
|
|
--- |
|
|
|
|
|
## 📄 View Notebook in Colab |
|
|
|
|
|
[](https://colab.research.google.com/drive/1X4QwSB48fddXATlJBYtab16l7TM72KZk?usp=sharing) |
|
|
|
|
|
You can explore the full .ipynb notebook on Google Colab using the button above. |
|
|
|
|
|
--- |
|
|
|
|
|
## 📁 Project Structure |
|
|
|
|
|
``` |
|
|
├── EnhancedTutorSystem.ipynb |
|
|
├── README.md |
|
|
├── requirements.txt |
|
|
``` |
|
|
|
|
|
--- |
|
|
|
|
|
## 🧠 Model Info |
|
|
|
|
|
This project uses (but does not rehost) Meta's official instruction-tuned model: |
|
|
|
|
|
[](https://huggingface.co/meta-llama/Llama-3.2-3B-Instruct) |
|
|
|
|
|
The model is loaded via transformers using 4-bit quantization (BitsAndBytes) |
|
|
|
|
|
**Note:** You must agree to Meta's license to access the model. |
|
|
|
|
|
--- |
|
|
|
|
|
## 🎯 Features |
|
|
|
|
|
- ✍️ Adaptive questions across difficulty levels |
|
|
- 📊 Real-time performance tracking |
|
|
- 🤓 Intelligent feedback on every answer |
|
|
- 💡 LangGraph-powered multi-agent workflow |
|
|
- 🧵 Fully reproducible session history |
|
|
|
|
|
--- |
|
|
|
|
|
## 🔜 Coming Soon |
|
|
|
|
|
- 🌐 A Hugging Face Space with a user-friendly UI |
|
|
- 📝 Student progress export to PDF |
|
|
- 🎯 Topic-based quiz sessions |
|
|
- 🧪 Integration with LangChain for evaluation metrics |
|
|
|
|
|
--- |
|
|
|
|
|
## 📄 License |
|
|
|
|
|
This project is released under the MIT License. |
|
|
|
|
|
--- |
|
|
|
|
|
## 🙌 Acknowledgments |
|
|
|
|
|
- 🧠 Meta AI for LLaMA-3 |
|
|
- 🔄 LangGraph by LangChain |
|
|
- 🤗 Hugging Face for open infrastructure |
|
|
|
|
|
--- |
|
|
|
|
|
## 📬 Contact / Feedback |
|
|
|
|
|
[](https://github.com/Mrigank005) |
|
|
[](https://www.linkedin.com/in/mrigank005) |
|
|
|
|
|
Feel free to raise issues or suggestions on GitHub |
|
|
Or connect via Hugging Face community tab! |
|
|
|
|
|
**Happy learning!** 💡 |
|
|
|
|
|
--- |
|
|
|
