Skip to content

Fizza-Mukhtar/NeuraTutor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

4 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿง  NeuraTutor โ€” Your ADHD-Friendly AI Study Buddy

NeuraTutor is a personalized AI-powered study assistant built to support studentsโ€”especially those with ADHDโ€”through their academic challenges with clarity, structure, and a sprinkle of motivation.

This app combines the power of computer vision (OCR), large language models (Google's Gemma 2B), and an ADHD-aware tutoring style to help students understand homework, boost focus, plan tasks, fix mistakes, and receive emotional support.

๐Ÿ’ก Features

๐Ÿ“ธ Solve from Image

Upload a photo of your homework or question. NeuraTutor extracts text using OCR and then provides a step-by-step explanation using a helpful teaching tone.

๐Ÿ˜Œ Pep Talk

Need a boost? Tell NeuraTutor how you're feeling and it will generate an encouraging, mood-specific message.

๐Ÿ“… Task Planner

Input your big task and get a breakdown into smaller, manageable steps based on the Pomodoro technique, perfect for maintaining focus.

โŒ Mistake Fixer

Made a mistake? Paste your wrong answer and NeuraTutor will gently analyze what went wrong and help you learn from it.

๐ŸŽฏ Focus Booster

Get quick actionable tips to bring your focus back when you're distracted or feeling overwhelmed.

โš™๏ธ Tech Stack

  • Frontend UI: Gradio
  • Backend Model: Google Gemma 1.1 2B-IT
  • OCR: Tesseract via pytesseract
  • Image Handling: PIL
  • Deep Learning Framework: Hugging Face Transformers + PyTorch

๐Ÿš€ Installation

โš ๏ธ This app requires a GPU runtime (e.g., Colab Pro or local with CUDA) for optimal performance with Gemma.

1. Clone the repository

git clone https://github.com/Fizza-Mukhtar/NeuraTutor.git
cd NeuraTutor

2. Install dependencies

pip install -r requirements.txt

3. Run the app

python app.py

๐Ÿง‘โ€๐ŸŽ“ Tutor Personality

All model responses are prompted to be:

  • Encouraging and patient
  • Structured for clarity
  • ADHD-friendly (short bursts of information, simple words, emotional support)

๐Ÿ“ธ Screenshot

a1 image a5

๐Ÿค Contributions

Contributions, ideas, and feedback are welcome! Please open an issue or PR.

๐Ÿ›ก๏ธ License

MIT License

๐Ÿ™Œ Acknowledgments

  • Hugging Face for model support
  • Google for the Gemma models
  • Gradio for easy UI creation
  • Everyone supporting neurodivergent-friendly education ๐Ÿ’›

About

๐Ÿง  NeuraTutor โ€” An ADHD-friendly AI study assistant that explains homework, gives pep talks, breaks down tasks, and boosts focus using the Gemma LLM + OCR + Gradio UI.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages