Skip to content

Nouran252/EduPal-Ai-tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EduPal-Ai-tool

Python Version
License: MIT

📌 Overview

EduPal-Ai-tool is an AI-driven educational assistant designed to support learning and content creation. Built in Python, the tool includes modules for summarization, quiz generation, speech output, and interactive educational workflow. It’s ideal for educators, learners, and AI enthusiasts looking to explore how intelligent systems can enhance education.

🚀 Key Features

  • Summarization: Automatically generate concise summaries of input text or learning material (see summary.py).
  • Quiz Generation: Create multiple-choice quiz questions from provided content (see quiz_gen.py).
  • Speech Output: Produce audio output for textual content (via speech_output.wav and relevant module).
  • Interactive GUI/Workflow: A home interface (home.py) that ties together the modules for a smoother experience.
  • Easy to extend: Designed with modularity in mind, enabling further additions like NLP pipelines, LLM-based assistants, or educational dashboards.

🧰 Tech Stack

  • Python (3.8+)
  • Key dependencies: (listed in requirements.txt)
    • e.g., numpy, pandas, transformers, langchain, PyTorch (adjust according to your actual requirements)
  • Modules/files:
    • home.py – Entry point and main interface
    • summary.py – Text summarization logic
    • quiz_gen.py – Quiz generation logic
    • speech_output.wav – Sample audio output (for demo)
  • Data files: Optionally, you may include sample learning materials or datasets for demo/instruction.

🏁 Getting Started

  1. Clone the repository

    git clone https://github.com/Nouran252/EduPal-Ai-tool.git
    cd EduPal-Ai-tool
    
    
  2. Install dependencies

    pip install -r requirements.txt
  3. Run the tool

    python home.py

    Follow the prompts/interface to select summarization, quiz generation, or other available modules.

  4. Customize or extend

    • Add new content modules or algorithms (e.g., NLP tasks, LLM fine-tuning).
    • Modify GUI or CLI interface to fit your workflow.
    • Replace or enhance audio output module for more advanced TTS or multilingual support.

🎯 Use Cases

  • Teachers preparing lesson summaries and quizzes quickly.
  • Students generating study material from textbooks or articles.
  • AI/ML learners exploring practical modules in summarization, quiz creation, and speech synthesis.
  • Developers extending an educational AI assistant with custom logic or LLM integrations.

📝 Future Enhancements

  • Integrate large-language-model (LLM) based modules for richer content generation (question explanations, essay help).
  • Support multilingual input/output.
  • Add a web interface or dashboard for ease of use and distribution.
  • Provide dataset versioning and logging for model evaluation and analytics.

📁 Repository Structure

EduPal-Ai-tool/
│  home.py
│  summary.py
│  quiz_gen.py
│  requirements.txt
│  speech_output.wav
│  README.md
└───pages/             ← Optional folder for additional content or UI assets

✅ Contributing

Contributions are welcome! Whether fixing bugs, adding new features, or improving documentation:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/your-feature).
  3. Commit your changes and push the branch (git push origin feature/your-feature).
  4. Create a Pull Request describing your changes and why they’re beneficial.

🧑‍💻 Author

Nouran Mahmoud Mohamed AI Engineer & Student — Faculty of Computer and Information Science, Ain Shams University GitHub | LinkedIn

📄 License

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


---

If you like, I can **generate a complete markdown file**, including badges, table of contents, image/logo placeholders, and format it for a “GitHub Ready” look. Would you like me to do that?
::contentReference[oaicite:1]{index=1}

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages