- 📖 Overview
- ✨ Features
- ⚙️ Installation
- 🚀 Usage
- 🗂️ Project Structure
- 🤝 Contributing
- 📝 License
- 📬 Contact
The Movie Recommender System is a web application built using Streamlit that allows users to explore and receive movie recommendations based on various algorithms. The system leverages machine learning models to provide recommendations and offers an intuitive and user-friendly interface with a dark theme for enhanced usability.
- Personalized Recommendations: Get movie suggestions based on your preferences.
- Search Functionality: 🔍 Easily search for your favorite movies.
- Dark Theme: 🖤 A visually appealing dark theme for comfortable usage.
- Interactive UI: User-friendly interface with Streamlit for seamless interaction.
- Scalable: Easily extendable to include more features and improve recommendation algorithms.
- Cosine Similarity-Based Recommendations: After clicking "Give Recommendation," the system provides 5 movie recommendations that are closest in cosine similarity after vectorizing the tags and selecting the top 5 closest matches.
-
Clone the repository:
git clone https://github.com/chayanC7mondal/Movie-Recommender.git cd Movie-Recommender
-
Create a virtual environment (optional but recommended):
python3 -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate`
-
Install the required packages:
pip install -r requirements.txt
-
Run the application:
streamlit run app.py
-
Access the application:
Open your web browser and go to
http://localhost:8501
to interact with the Movie Recommender System. -
Explore and get recommendations:
- Use the app to search for movies, receive personalized recommendations, and explore various features.
- After clicking "Give Recommendation," you'll get 5 movie recommendations that are closest in cosine similarity to the movie tags you selected.
Movie-Recommender/
├── app.py # Main application file
├── data/ # Dataset and related files
├── models/ # Pre-trained models and scripts
├── utils/ # Utility scripts for data processing and model evaluation
├── requirements.txt # Python dependencies
├── README.md # Project documentation
└── .streamlit/ # Streamlit configuration files (theme, etc.)
Contributions are welcome! If you have suggestions for improvements, feel free to submit a pull request or open an issue.
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch
). - Commit your changes (
git commit -m 'Add some feature'
). - Push to the branch (
git push origin feature-branch
). - Open a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.
Chayan Mondal - LinkedIn - [email protected]
Project Link: https://github.com/chayanC7mondal/Movie-Recommender
Created by Chayan Mondal ✨