# 🎓 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/)

---

## 🚀 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://i.imgur.com/O7vEFXh.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

---

## 🎯 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

---

## 📄 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.”