CineMatch

A Simple content-based movie recommender trained from TMDB data and built with Streamlit UI.

Data Source: TMDB 5000 Movie Dataset

Deployed App: https://cinematch-abhr-0.streamlit.app

Requirements

• Python 3.13
• See requirements.txt

Quickstart

1. Clone the repository:

git clone https://github.com/abhr-0/cinematch

2. Install dependencies or use nix develop:

pip install -r requirements.txt

3. Set TMDB Bearer Token in .streamlit/secrets.toml:

TMDB_BEARER_TOKEN = "your_bearer_token_here"

4. Run the Streamlit app:

streamlit run app/app.py

Docker (or, Podman)

1. Build the Docker image:

docker build -t cinematch .

2. Run the container:

docker run -p 8501:8501 -v=.streamlit/secrets.toml:/app/.streamlit/secrets.toml:ro cinematch