FilipRokita / python-ai-quiz

A Flask-based quiz app that dynamically loads questions from a database, making it easy to customize. Users can take quizzes, track high scores, and manage sessions. By default, the quiz focuses on AI in Python, but can be easily adapted to any topic.

🧠 Python AI Quiz

---

This is a web-based Python AI Quiz Application built using Flask, SQLAlchemy, and Bootstrap. The quiz focuses on Artificial Intelligence (AI) topics such as deep learning, computer vision, and natural language processing (NLP).

🎯 Main Advantage

The quiz questions are stored in a database (SQLite) instead of being hardcoded, making it effortlessly customizable. This allows users to easily modify, expand, or update the quiz content without changing the application’s code, ensuring scalability and flexibility. The included AI-related questions may serve as placeholders, meaning the quiz can be quickly adapted to any topic by simply updating the database.

🚀 Features

✅ AI-related quiz with multiple-choice questions
✅ User session management (tracks the highest score)
✅ Dynamic leaderboard displaying the best score
✅ Responsive design using Bootstrap
✅ Modular and structured Flask application
✅ SQLite database integration

💻 Technologies Used

• Python (Flask, SQLAlchemy, Flask-Session)
• HTML, CSS, Bootstrap (Frontend)
• SQLite (Database)
• Docker (Environment)

📜 Installation Guide (with Docker)

1️⃣ Clone the Repository

git clone https://github.com/FilipRokita/python-ai-quiz
cd python-ai-quiz

2️⃣ Run Docker Compose

docker compose up -d

✅ Visit: http://0.0.0.0:8082/

📜 Installation Guide (without Docker)

1️⃣ Clone the Repository

git clone https://github.com/FilipRokita/python-ai-quiz
cd python-ai-quiz

2️⃣ Install Dependencies

pip install -r requirements.txt

3️⃣ Initialize the Database

python init_db.py

4️⃣ Add Python AI Quiz Questions

python add_questions.py

5️⃣ Run the Flask App

python app.py

✅ Visit: http://127.0.0.1:5000/

---

📌 Author

👨‍💻 Filip Rokita
🔗 LinkedIn Profile
🔗 GitHub Profile

---

📝 License

This project is licensed under the MIT License.

---

🌟 If you like this project, please give it a ⭐ on GitHub!

🚀 Happy coding! 😊