Skip to content

sahmed104/Parwaaz

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Parwaaz - AI-Powered Learning Assistant for Middle School

Parwaaz is a generative AI-powered educational assistant designed specifically for middle school students (Grades 6–8). It helps learners explore subjects like English, Science, and Math through interactive tools including quizzes, flashcards, summaries, and visual explanations.

🚀 Features

  • 📚 Subject-Based Learning: Choose your grade and subject to generate topic-specific educational content.
  • 🧠 AI-Generated Flashcards: Instantly create interactive flashcards for key concepts.
  • ✍️ Quiz Generator: Auto-generate multiple-choice quizzes to reinforce understanding.
  • 📝 Summarizer: Get clean, structured summaries of any topic in simple language.
  • 🎓 Student-Friendly UI: Built with TailwindCSS and Flask for a smooth learning experience.

🛠️ Tech Stack

  • Backend: Flask (Python)
  • Frontend: HTML + TailwindCSS
  • AI Integration: OpenAI API
  • Version Control: Git & GitHub

📁 Folder Structure

Parwaaz/
├── static/                 # CSS, JS, and image files
├── templates/              # Jinja2 HTML templates
├── app/                    # Flask backend logic (views, API handling)
├── run.py                  # Entry point to run the Flask app
├── .env                    # Environment variables (excluded from Git)
└── README.md               # Project documentation

⚙️ Setup Instructions

  1. Clone the repository
git clone https://github.com/sahmed104/GENAI_003_PROJECT_8.git
cd GENAI_003_PROJECT_8
  1. Create a virtual environment and install dependencies
python -m venv venv
venv\Scripts\activate        # (Windows)
# or
source venv/bin/activate     # (macOS/Linux)

pip install -r requirements.txt
  1. Add your OpenAI API key to .env
OPENAI_API_KEY=your_key_here
  1. Run the app
python run.py

✨ Authors

This project was developed by a dedicated team of three collaborators focused on building accessible, AI-powered educational tools for middle school students. Each team member contributed to design, development, and testing to bring Parwaaz to life.

👩‍💻 Zainab Siddiqi  
👨‍💻 Saud Ahmed  
👨‍💻 Shehzad Ahmed

About

AI-powered learning assistant for middle school students with quizzes, flashcards, summaries, and visual explanations. Built with Flask, TailwindCSS, and OpenAI.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors