/quiz-bot

Primary LanguagePython

Quiz Bot 🤖

Welcome to Quiz Bot, a fun and interactive way to test your knowledge directly in Telegram! Whether you have a minute to spare or an hour to kill, Quiz Bot is your go-to for an engaging trivia experience.

Features

  • Wide Range of Topics: Choose from various categories to test your knowledge in your area of interest.
  • Flexible Difficulty Levels: Select from easy, medium, or hard questions to suit your trivia skill level.
  • Interactive Gameplay: Engage with the bot through a user-friendly interface, making your quiz experience enjoyable and straightforward.
  • Real-Time Feedback: Receive immediate responses to your answers, along with the correct answer for a learning experience.
  • Play Anytime, Anywhere: Accessible through Telegram, play whenever you want, wherever you are.

How to Play

  1. Start the Bot: Find @quiz_doroshenko_bot in Telegram.
  2. Choose Your Preferences: Select the number of questions, category, and difficulty level.
  3. Answer Questions: Respond to the questions and see how many you get right!
  4. Get Your Score: At the end of the quiz, see your score and challenge yourself to improve.

Technologies Used

  • Python: The core language used for bot development.
  • Aiogram: A powerful framework for Telegram bot development.
  • MongoDB: For efficient data storage and retrieval.
  • Docker: Ensuring easy deployment and scalability.

Setup and Installation

To set up the bot locally or contribute to its development, follow these steps:

  1. Clone the Repository: git clone https://github.com/nikan2110/quiz-bot.git
  2. Install Dependencies: Run pip install -r requirements.txt to install the required Python packages.
  3. Set Environment Variables: Configure the necessary environment variables for the bot to function.
  4. Run the Bot: Execute python main.py to start the bot locally.