Skip to content

CineMatch is a content-based movie recommendation web app built using Python, Streamlit, and the TMDB API. It suggests similar movies based on title, genre, and director .

Notifications You must be signed in to change notification settings

alcode-10/cinematch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎥 CineMatch – Movie Recommendation System

CineMatch is a content-based movie recommendation web app built using Streamlit and powered by TMDB API.
It suggests similar movies based on a selected title and shows movie posters, director, cast, rating, and description.


🔍 Features

  • 🔎 Search for any movie from your dataset
  • 🎯 Get top 5 similar movie recommendations
  • 🖼️ Display posters using TMDB API
  • 🎬 View director and cast details
  • ⭐ Show movie ratings and overviews
  • 💻 Built using Python, Streamlit, scikit-learn, and TMDB API

📦 Dataset

We use a custom cleaned version of IMDb data:
imdb_clean.csv containing:

  • title
  • genre
  • director
  • release_year, etc.

🛠️ Tech Stack

Tool Usage
Python Core language
Streamlit Web UI
scikit-learn TF-IDF + Cosine Similarity
TMDB API Movie posters, overview, cast, director
Pandas / NumPy Data wrangling
Requests API requests

🚀 How To Run Locally

# Clone the repo
git clone https://github.com/yourusername/movie-recommender-system.git
cd movie-recommender-system

# Install dependencies
pip install -r requirements.txt

# Run the app
streamlit run app.py

About

CineMatch is a content-based movie recommendation web app built using Python, Streamlit, and the TMDB API. It suggests similar movies based on title, genre, and director .

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages