Skip to content

Latest commit

 

History

History
82 lines (55 loc) · 2.22 KB

README.md

File metadata and controls

82 lines (55 loc) · 2.22 KB

BrainTeaserBot

BrainTeaserBot is an AI-powered quiz trivia website that offers an engaging and interactive experience for quiz enthusiasts. Built using the MERN stack, it leverages Gemini AI and the Open Trivia DB API to deliver diverse and challenging trivia questions across various categories.

🚀 Features

  • AI-Powered Quiz Search: Get personalized quiz recommendations using the Gemini AI, offering an intelligent and customized quiz experience.
  • Wide Range of Categories: Choose from different quiz categories ranging from science, history, sports, and more.
  • Multiple Difficulty Levels: Select quizzes based on your preferred difficulty level - Easy, Medium, or Hard.
  • Responsive Design: Fully responsive design to ensure a seamless experience across all devices.
  • Real-Time Updates: Enjoy real-time loading of quizzes and score updates for a smooth gameplay experience.

🛠️ Technologies Used

  • Front-end: React.js, JavaScript, Tailwind CSS
  • Back-end: Node.js, Express.js
  • Database: MongoDB
  • APIs:
    • Open Trivia DB API for fetching trivia questions
    • Gemini AI for quiz search and recommendation

📦 Getting Started

Follow these instructions to set up the project locally.

Prerequisites

Ensure you have the following installed:

  • Node.js (v14+)
  • npm
  • MongoDB

Installation

  1. Clone the repository:

    git clone https://github.com/Animatedguess/BrainTeaserBot.git
  2. Navigate to the project directory:

    cd brainteaserbot
  3. Install dependencies for the client and server:

    # Install dependencies
    npm install
    
  4. Open your browser and go to:

    http://localhost:3000
    

📂 Project Structure

brainteaserbot/
│
├── public/             # Public files
├── src/                # Source files   
├── ...                 # React components, styles, and more  
│
└── README.md

🎨 Screenshots

Include screenshots of the website here to showcase the UI and features.

📧 Contact

If you have any questions or feedback, please reach out: