Skip to content

hamadbijarani/AI-Quiz-Maker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 AI Quiz Maker

AI-powered quiz generator that creates interactive quizzes from PDF documents using LangChain, Google Generative AI, and Streamlit. Perfect for teachers, trainers, and students who want to turn learning materials into quizzes instantly.


🚀 Features

  • 📄 Upload PDFs → Extracts text and processes it.
  • 🤖 AI-Powered → Generates quiz questions with multiple-choice answers.
  • 📝 Interactive Quiz → Take the quiz inside the Streamlit app.
  • Instant Feedback → Know if your answer is correct on submission.
  • 💾 FAISS Vector Store → Efficient semantic search for context retrieval.

🛠️ Tech Stack


📂 Project Structure

AI-Quiz-Maker/
│── Pics
  │── Interface 1.png
  │── Interface 2.png
│── main.py              # Streamlit app entry point
│── requirements.txt     # Dependencies
│── LICENSE              # Apache License 2.0
│── README.md            # Project documentation

⚙️ Installation

  1. Clone the repo
git clone https://github.com/hamadbijarani/AI-Quiz-Maker.git
cd AI-Quiz-Maker
  1. Create a virtual environment (recommended)
python -m venv venv
source venv/bin/activate   # Linux/Mac
venv\Scripts\activate      # Windows
  1. Install dependencies
pip install -r requirements.txt
  1. Set up environment variables Create a .env file in the root directory:
GOOGLE_API_KEY=your_api_key_here

▶️ Usage

Run the Streamlit app:

streamlit run main.py
  1. Upload a PDF document.
  2. The AI generates quiz questions.
  3. Start the quiz and test your knowledge interactively!

📸 Demo (Optional)

"Home Screen"

"During A Quiz"


🤝 Contributing

Contributions are welcome!

  • Fork the repo
  • Create a new branch (feature/your-feature)
  • Commit changes
  • Open a pull request

📜 License

This project is licensed under the Apache License 2.0 – feel free to use and modify.

About

This is a RAG-based streamlit app, which takes PDF documents as input and then user can attempt an interactive quiz online!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages