https://github.com/krraviongit/the_movie_recommender
AI based Movie Recommendation System
https://github.com/krraviongit/the_movie_recommender
Last synced: 8 months ago
JSON representation
AI based Movie Recommendation System
- Host: GitHub
- URL: https://github.com/krraviongit/the_movie_recommender
- Owner: krRaviongit
- Created: 2025-04-06T06:26:33.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-06T13:56:24.000Z (about 1 year ago)
- Last Synced: 2025-04-06T14:37:07.377Z (about 1 year ago)
- Language: Python
- Homepage: https://ai-movie-recommender-4yht2jlpy9d44m5gtk9fnp.streamlit.app/
- Size: 20.3 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
🎬🍿Movie Recommender System
> *Unlock Your Next Favorite Film!*
---
## 🚀 Project Overview
The **Movie Recommender System**, built using **Python** and **Natural Language Processing (NLP)**, offers a user-friendly way to discover your next favorite movie. Using the **bag-of-words** technique, we generate recommendations based on similarity, tags, genre, and production company. Additionally, users can view detailed information about each movie and its cast.
---
## 📸 Sample Application Screenshots
### 🔍 Home Page: Get Personalized Recommendations
### 📃 Description Page: Explore Movie Details
### 🎬 Check All Movies Page: Browse with Ease
---
## 📺 Watch the Demo
For a live demonstration of our **Movie Recommender System**, watch the video below:
[](https://youtu.be/0BJgu4qZqOM)
---
## 🛠️ Installation Guide
Follow these steps to set up and run the application:
### 1️⃣ Clone the Repository
```bash
git clone https://github.com/krRaviongit/The_movie_recommender.git
cd The_movie_recommender
```
### 2️⃣ Create a Virtual Environment
```bash
python -m venv env
# Activate the environment
source env/bin/activate # macOS/Linux
env\Scripts\activate # Windows
```
### 3️⃣ Install Dependencies
```bash
pip install -r requirements.txt
```
### 4️⃣ Download Required Files from Google Drive
Some large `.pkl` model/data files are hosted externally due to GitHub file size limits. Use the script below to download them automatically:
```bash
python download_files.py
```
This script uses **gdown** to securely fetch necessary files from Google Drive and places them in the correct directories.
### 5️⃣ Run the Application
```bash
streamlit run main.py
```
**⚠️ Note:** The first time you run the application, it may take a few seconds to initialize while loading the models and data.
---
## 💡 Features
✅ **Personalized Movie Recommendations** based on genres, cast, and production companies
✅ **Seamless Streamlit Interface** for an intuitive user experience
✅ **Detailed Movie Descriptions** including cast information
✅ **Full Movie Database** to browse all available movies
✅ **Fast and Efficient Recommendation System** powered by **NLP**
---
## 🎯 Discover Your Next Favorite Movie!
Enjoy a smarter way to explore films with our **AI-powered Movie Recommender System**. Whether you're in the mood for an action thriller, a romantic drama, or a sci-fi adventure, our app has you covered. 🌟
---
📌 **Developed by**
* **Kumar Ravi** – [GitHub](https://github.com/krRaviongit)
* **Abinash Giri** – [GitHub](https://github.com/ABIN2005)
---
## 📜 License
This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.
---
🚀 **Happy Watching! 🎥🍿**
---
Made with ❤️ by Kumar Ravi