Update README.md

README.md

@@ -1,14 +1,119 @@
+# 🎓 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
+
 ---
-title: EduTutor AI
-emoji: 🔥
-colorFrom: green
-colorTo: gray
-sdk: gradio
-sdk_version: 5.33.0
-app_file: app.py
-pinned: false
-license: mit
-short_description: AI-Powered Quiz & Feedback Generator with IBM Granite LLM
+
+## 📷 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
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+> “AI can’t replace teachers — but it can empower students.”