Skip to content

AI-powered tuition assistant built with Gradio + Groq (multi-level subjects, file/image support, PDF export).

License

Notifications You must be signed in to change notification settings

umer1556/ai-tuition-center

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎓 AI Tuition Centre

Empowering learners with an AI-powered personal tutor tailored for School, College, and University levels.

Gradio Groq Python Hugging Face

🌟 Overview

AI Tuition Centre is a sophisticated learning assistant designed to provide context-aware academic support. By leveraging the Groq LPU™ Inference Engine, it delivers near-instant responses to complex queries, whether they are text-based, uploaded documents, or visual problems.

This project was built to bridge the gap between static AI chats and personalized tutoring by offering specific help modes (like step-by-step solving and study planning) tailored to the student's academic level.


✨ Features

  • 🎯 Multi-level Logic: Customized response styles for School, College, and University learners.
  • 🧠 Specialized Help Modes: - Explain: Conceptual breakdowns.
    • Step-by-step: Detailed problem-solving.
    • Check Work: Feedback on user-submitted answers.
    • Study Plan: Personalized learning paths.
    • Quiz Mode: Test your knowledge instantly.
  • 📄 Document Intelligence: Support for .pdf and .txt for context-based tutoring.
  • 🖼️ Visual Learning: Image support for solving handwritten or textbook questions.
  • 📥 Exportable Insights: Save your learning sessions directly to PDF using ReportLab.

🛠️ Tech Stack

  • Frontend: Gradio
  • LLM Orchestration: Groq API (Llama-3 models)
  • PDF Processing: PyPDF & ReportLab
  • Environment Management: python-dotenv

🚀 Quick Start

1. Clone the repository

git clone [https://github.com/Umer1556/AI-Tuition-Centre.git](https://github.com/Umer1556/AI-Tuition-Centre.git)
cd AI-Tuition-Centre

2. Install dependencies

pip install -r requirements.txt

3. Set up Environment Variables

Create a .env file in the root directory and add your Groq API key:

GROQ_API_KEY=your_api_key_here

4. Run the Application

python app.py

🌐 Live Demo

Experience the tutor in action without any setup: 👉 Try it on Hugging Face Spaces


📸 Screenshots

Home UI Chat Example


👤 Author

Umer1556


📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

About

AI-powered tuition assistant built with Gradio + Groq (multi-level subjects, file/image support, PDF export).

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Languages