🎬 Cinemania 🎬

Cinemania is a web application that uses generative AI to create a quiz on a movie of the user's choice.

Technologies used

• Front-end: React, React Router
• Back-end: Flask
• APIs: OpenAI API, The Movie Database (TMDB) API, Wikipedia API
• LLM: GPT-3.5 Turbo
• UI/UX prototyping: Penpot
• Scrapping: BeautifulSoup

Getting Started

1. Clone this repository

git clone https://github.com/awonyu9/cinemania.git
cd cinemania

2. Get your API keys from OpenAI and The Movie Database (TMDB)

a. In the back directory, make a copy of the file named .env.example and name it .env.

b. In .env, update the values of OPENAI_API_KEY and TMDB_API_KEY with your API keys.

3. Run the application locally

In one terminal, start the back-end:

*Make sure to have Python and pip installed on your machine.

cd back

# activate virtual environment
.venv\Scripts\activate # Windows
source .venv/Scripts/activate # Linux/macOS

# install required back-end dependencies
pip install -r requirements.txt

# start local server
py app.py

In another terminal, start the front-end:

*Make sure to have Node and npm installed on your machine.

cd front

# install required front-end dependencies
npm install

# start local server
npm run dev

4. Access the application in your browser at: http://127.0.0.1:5173/