haiderijaz/EduGenie-AI-Academic-Assistant

🧠 EduGenie – AI Academic Assistant

EduGenie helps students and teachers generate educational content with AI — summaries, quizzes, lesson plans, diagrams, and explanations from PDFs, audio, images, or typed text.

✨ Features

• —📄 Accepts input from:
• —Typed academic content
• —PDF textbooks
• —Scanned diagrams (OCR)
• —Voice recordings (speech-to-text)
• —🎯 Generates:
• —📘 Summaries
• —🧠 Explanations
• —📝 Quizzes (MCQs, True/False, Fill in the Blank)
• —📅 Lesson Plans (with class/grade)
• —🖼️ Mermaid.js Diagrams
• —🌐 Supports output in multiple languages (e.g., English, Urdu, Arabic)
• —📚 Bloom’s Taxonomy quiz level detection and customization
• —🔊 Text-to-Speech playback of generated output
• —🧠 Built-in RAG (Retrieval-Augmented Generation) for file-specific Q&A
• —📤 Export results as .txt or .pdf files

📦 Directory Structure

EduGenie/
├── app.py
├── requirements.txt
├── README.md
├── style.css
├── static/
│   └── index.html
└── utils/
    ├── bloom_detector.py
    ├── diagram_ocr.py
    ├── export_tools.py
    ├── llm_client.py
    ├── pdf_handler.py
    ├── prompt_builder.py
    ├── rag_client.py
    ├── text_to_speech.py
    └── voice_to_text.py

🚀 Run Locally

git clone https://huggingface.co/spaces/your-username/EduGenie
cd EduGenie
pip install -r requirements.txt
python app.py

🧠 Technologies Used

• —Gradio — UI framework
• —Groq — LLaMA 3 API calls
• —Whisper — audio transcription
• —Tesseract + OpenCV — diagram OCR
• —SentenceTransformers + FAISS — RAG for vector search
• —ReportLab + python-docx — file export
• —gTTS — text-to-speech

🔖 License

MIT License – free to use and modify for educational purposes.