File size: 3,745 Bytes
96668f9
 
 
 
 
 
3144dae
 
96668f9
608465f
 
 
 
 
 
 
 
 
0fc5692
608465f
0fc5692
96668f9
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
608465f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
a9545f0
608465f
 
 
73e4985
608465f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
a9545f0
 
96668f9
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
---
license: mit
title: EduTutor AI
sdk: gradio
emoji: πŸš€
short_description: AI-Powered Quiz & Feedback Generator with IBM Granite LLM
colorFrom: blue
colorTo: green
---
# πŸŽ“ EduTutor AI – Personalized Learning & Assessment System

EduTutor AI is an AI-powered personalized tutoring tool designed to generate custom quizzes and feedback based on a student's score and topic of interest.

Built using the powerful IBM Granite LLM and Gradio, this app enables intelligent learning and self-assessment.

[![IBM Granite LLM](https://img.shields.io/badge/IBM%20Granite%20LLM-Model-blue)](https://huggingface.co/ibm-granite/granite-3.3-2b-instruct)
[![Gradio](https://img.shields.io/badge/Gradio-Interface-orange)](https://www.gradio.app/)
[![Python](https://img.shields.io/badge/Made%20With-Python-green)](https://www.python.org/)

---

## 🎯 Submission for IBM InnovateX Hackathon 2025

This project was developed as part of the IBM InnovateX Hackathon 2025, showcasing the use of IBM Granite LLM for solving real-world educational challenges using AI.

πŸ‘₯ **Team Name:** CodeCrafters

πŸ‘©β€πŸ’» **Team Members:** Koyyada Anusha, Muddassir Shakhan

πŸ“„ **Initial Solution Submission:** As part of the hackathon requirements, we submitted a project proposal and functional overview. [View Submitted Solution](https://drive.google.com/file/d/12NDxLZR-52vAoWG8LvyqDe2P65nbdyws/view?usp=sharing)

We collaboratively developed this solution from idea to implementation to address the core goals of personalized learning and automated assessment.

---

## πŸ™‹β€β™€οΈ Developed By

### Koyyada Anusha

B.Tech - CSE (AI & ML) - Year: 2022-2026

Vaageswari College of Engineering - Roll No: 22S41A6693

GitHub: https://github.com/Anusha-831

LinkedIn: https://www.linkedin.com/in/anusha-koyyada-8b3032261

Email: koyyadaanusha05@gmail.com

### Muddassir Shakhan

B.Tech - CSE (AI & ML) - Year: 2022-2026

Vaageswari College of Engineering - Roll No: 22S41A66C0

GitHub: https://github.com/Muddassirshakhan

LinkedIn: https://www.linkedin.com/in/muddassir-shakhan-559740257

Email: muddassirshakhan8@gmail.com

---

## πŸš€ Live Demo

πŸ”— [Click here to use EduTutor AI](https://huggingface.co/spaces/Anusha831/EduTutor-AI)

---

## πŸ’‘ Features

- πŸ” Topic-Based Quiz Generation: Enter any topic (e.g., Algebra, History, Physics) and get a set of tailored multiple-choice questions.
- πŸ“Š Score-Aware Feedback: Receive personalized feedback and learning tips based on your performance.
- πŸ€– Powered by IBM Granite LLM: High-quality AI responses backed by a powerful open-source LLM.
- 🧠 No Coding Required: User-friendly interface with sliders and input boxes using Gradio.
- 🌐 Deploys on Hugging Face Spaces: Free, fast, and publicly accessible.

---

## πŸ› οΈ Technologies Used

- 🧠 IBM Granite 3.3 2B Instruct LLM (via Hugging Face)
- 🐍 Python
- πŸŽ›οΈ Gradio – For building interactive UI
- πŸ“š Transformers by Hugging Face
- πŸ’» Google Colab & GitHub for development

---

## πŸ“· App Preview

![App Screenshot](https://cdn-uploads.huggingface.co/production/uploads/679759cde60ab66534597fcf/cds3IABbgBBJr7UukD_Ow.png)

---

## πŸ“¦ Installation & Setup (Optional for Local Use)

If you want to run it locally:

`bash

git clone https://github.com/Anusha-831/EduTutor-AI.git

cd EduTutor-AI

pip install -r requirements.txt

python app.py

---

## πŸ“„ License

This project is licensed under the MIT License. Feel free to use, modify, and share.

---

## ⭐️ Acknowledgements

πŸ€– **IBM Granite Models –** for the open-source LLM

πŸ§ͺ **Gradio –** for building the UI effortlessly

🧠 **Hugging Face –** for hosting the app

---

> β€œAI can’t replace teachers β€” but it can empower students.”