🧠 AI Quiz Generator

A simple and powerful AI-powered quiz generator built with Streamlit.
Enter any topic and get a high-quality multiple-choice quiz with explanations in seconds.

✨ Features

• Generate quizzes on any topic
• Choose number of questions (3–20)
• Select difficulty level (Easy / Medium / Hard)
• Multi-language support (English, Turkish, Spanish, German, French)
• Clean multiple-choice format (A, B, C, D)
• Correct answer + detailed explanation
• Download quiz as JSON or Text
• Supports multiple AI providers:
  • OpenAI
  • Groq
  • xAI (Grok)

🚀 Installation

1. Clone the repository:

git clone https://github.com/dinguk0624/ai-quiz-generator.git
cd ai-quiz-generator

2. Create a virtual environment (recommended):

python -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

4. Create a .env file:

cp .env.example .env

5. Add your API key to the .env file:

OPENAI_API_KEY=sk-...
# or
GROQ_API_KEY=gsk_...
# or
XAI_API_KEY=xai-...

6. Run the app:

streamlit run app.py

📦 Project Structure

ai-quiz-generator/
├── app.py              # Main application
├── requirements.txt    # Dependencies
├── .env.example        # Example environment variables
├── .gitignore
├── LICENSE
└── README.md

🔑 API Keys

You only need one of the following:

Provider	Environment Variable	Recommended Model
OpenAI	OPENAI_API_KEY	gpt-4o-mini
Groq	GROQ_API_KEY	llama-3.3-70b-versatile
xAI	XAI_API_KEY	grok-3

📄 License

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

🤝 Contributing

Contributions, issues and feature requests are welcome!

---

Made with ❤️ using Streamlit + AI