TrivAI

A Kahoot-style trivia game powered by generative AI, created for SBU Hacks 2025.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Demo
5. System Diagram
6. Contributing
7. Contact

About The Project

TrivAI is a submission for SBU Hacks, a hackathon hosted by the Stony Brook Computing Society.

This project is a Kahoot clone powered by generative AI. It showcases how artificial intelligence can revolutionize the creation and scaling of applications, challenging the often high costs of popular platforms. By simply providing a topic, TrivAI instantly generates a unique and engaging trivia game, demonstrating a new paradigm for accessible and dynamic educational technology.

Our goal is to highlight the potential of AI to democratize software development and combat unfair pricing in the market.

Our site is here! trivAI

(back to top)

Built With

This project was brought to life with these amazing technologies:

• 
• 
• 
• 
• 
• 

(back to top)

Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

Make sure you have the following installed:

• Node.js (which includes npm)

  # Download and install from the official website
  https://nodejs.org/

• Python 3.13+

  # Download and install from the official website
  https://www.python.org/

Installation

1. Clone the repo

   git clone https://github.com/drod75/trivAI.git
   cd trivAI

2. Set up the Frontend

   cd frontend
   npm install

3. Set up the Backend

   cd ../backend
   pip install -r requirements.txt

4. API Keys Create a .env file in the backend directory and add your Google Gemini API key:

   GOOGLE_API_KEY='YOUR_API_KEY'
   

(back to top)

Usage

1. Run the Backend Server From the backend directory:

   uvicorn main:app --reload --host 127.0.0.1 --port 8000

2. Run the Frontend Application From the frontend directory:

   npm run dev

Open your browser and navigate to http://localhost:3000 to see the application in action.

(back to top)

Demo

A video demonstration will be available here soon. Stay tuned!

Youtube Video Demo

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Contact

Project Link: https://github.com/drod75/trivAI

Team:

• David Rodriguez - LinkedIn
• Mukhammadali Yuldoshev - LinkedIn
• Faizan Khan - LinkedIn
• Zain Raza - LinkedIn

(back to top)