Demo Video
Movie Recommender System Project in Python
CineMatch is a content-based Movie Recommender System project in Python that suggests similar films from a catalogue of nearly 4,800 titles. Built with Python, Flask, pandas, scikit-learn and NLTK, it matches movies by story, genre, cast, themes and production studio using cosine similarity. Key features include five separate recommendation engines, rich movie details with rating, runtime, budget and cast, a modern dark-themed custom UI with live search, fully offline operation with no external APIs, smart pickle-based caching for fast startup, and a clean Flask JSON API. Ideal for BCA, MCA, B.Tech and M.Tech final year students. Includes source code, report, synopsis and PPT.
What You Will Get
The Movie Recommender System Project in Python (CineMatch) is a complete machine learning and web development package built for final year submissions. It analyses a catalogue of nearly 4,800 movies and recommends the closest matches to any title you select, using content-based filtering rather than simple popularity lists. The application combines a Flask backend, a custom single-page frontend, and a full content-based recommendation pipeline. Everything runs locally on your machine with no API keys and no internet dependency.
Key Features
- Five separate recommendation engines deliver matches by overall similarity, shared genres, same production studio, similar themes, and shared cast.
- Detailed movie information is available for every title, including overview, rating, runtime, budget, revenue, spoken languages, director, and top cast.
- A modern hand-built interface uses a dark gradient theme with live search autocomplete, animated stat counters, gradient poster cards, and a details modal.
- The entire system works offline, with no TMDB API calls, no external image hosts, and no CDN dependencies during a demo.
- Smart caching stores the computed similarity matrices as pickle files, so the app loads almost instantly after the first run.
- A clean JSON API separates the Flask backend from the frontend, exposing tidy endpoints for movie lists, recommendations, and details.
- Content-based filtering is implemented with CountVectorizer and cosine similarity, both of which are strong viva discussion topics.
- Gradient placeholder cards are generated on the fly for movie posters, keeping the project fully self-contained.
- The complete package includes source code, a project report, a synopsis, and a PPT presentation for submission.
Technology Stack
| Component | Technology |
| Backend | Python, Flask |
| Machine Learning | pandas, scikit-learn, NLTK |
| Vectorization | CountVectorizer |
| Similarity Logic | Cosine Similarity |
| Frontend | HTML, CSS, JavaScript |
| Dataset | TMDB 5000 Movies and Credits CSV |
| Caching | Pickle files |
| Platform | Web application, runs locally on any OS |
System Requirements
- Python 3.8 or above installed on the system.
- pip for installing the packages listed in requirements.txt.
- Flask for running the local web server.
- pandas, scikit-learn, and NLTK for data processing and similarity calculation.
- Any modern browser such as Chrome, Edge, or Firefox.
- Around 500 MB of free disk space for the dataset and cached similarity matrices.
How It Works
The two TMDB CSV files are merged and cleaned, pulling together overview, genres, keywords, cast, crew, and studio details for each movie. Each film is then converted into a bag of words, with stemming applied and stop words removed, and the content is grouped into five separate feature sets. CountVectorizer turns these tags into numeric vectors, and cosine similarity scores every movie against every other movie in the catalogue. When you pick a title, the results are sorted by similarity score and the top unique matches from all five engines are displayed instantly on screen.
Perfect For
This project suits BCA, MCA, B.Tech CS/IT, M.Tech, and MBA students who need a final year project that covers both machine learning and full-stack web development. It is well suited for viva presentations because vectorization, cosine similarity, and content-based filtering are common examiner questions that you can answer with a live demo. It also works as a strong portfolio and interview project, since recommender systems power platforms like Netflix, Amazon, and Spotify.
Future Enhancements
The project can be extended with real movie posters from a bundled image pack, collaborative filtering that blends user ratings with content matches, user accounts with watchlists and a personalised feed, filters for release year, language and minimum rating, cloud deployment for online access, a feedback loop where users rate recommendations, and an expanded dataset with newer titles.
Watch Project Demo
Watch the full project walkthrough and setup tutorial on our YouTube channel.
▶ Watch on YouTube – Decode It
More Details & Full Documentation
For complete project details, source code, and setup guide, visit the official project page.
Project Modules
- Load and merge the TMDB movies and credits CSV datasets
- Clean and preprocess movie data (overview, genres, keywords, cast, crew, studio)
- Build feature tags with stemming and stop-word removal
- Generate and cache similarity matrices as pickle files
Recommendation Module:
- Overall similarity engine (combined content match)
- Genre-based similarity engine
- Production studio based similarity engine
- Theme / keyword based similarity engine
- Cast-based similarity engine
User Module:
- Browse the full movie catalogue (approx. 4,800 titles)
- Live search with autocomplete suggestions
- Select any movie and view five sets of recommendations
- Open the details modal for overview, rating, runtime, budget, revenue, language, director and top cast
- View gradient poster cards and animated stat counters
API Module:
- Flask JSON endpoint for movie list
- Flask JSON endpoint for recommendations
- Flask JSON endpoint for movie details
Installation Guide
1. Download and extract the ZIP file 2. Open the project folder: cd Movie-Recommender-System 3. Create a virtual environment: python -m venv venv Windows: venv\Scripts\activate macOS / Linux: source venv/bin/activate 4. Install dependencies: pip install -r requirements.txt 5. Run the app: python app.py 6. Open http://127.0.0.1:5000 in your browser (First run takes longer while similarity matrices are built and cached)
FAQ for this project coming soon.
No reviews yet. Be the first to review!
Write a Review
Related Projects
38% OFF
Featured
33% OFF
Featured
38% OFF
Featured
60% OFF
Featured