EduTutor-AI / README.md
Anusha831's picture
Update README.md
73e4985 verified
---
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.”