akashraut commited on
Commit
65b01d8
Β·
verified Β·
1 Parent(s): 25dbe15

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +31 -17
README.md CHANGED
@@ -1,20 +1,34 @@
1
- ---
2
- title: RECOMMENDATION SYSTEM
3
- emoji: πŸš€
4
- colorFrom: red
5
- colorTo: red
6
- sdk: docker
7
- app_port: 8501
8
- tags:
9
- - streamlit
10
- pinned: false
11
- short_description: Plot based recommendation movies list
12
- license: mit
13
- ---
14
 
15
- # Welcome to Streamlit!
 
 
 
 
 
16
 
17
- Edit `/src/streamlit_app.py` to customize this app to your heart's desire. :heart:
 
 
 
 
 
 
 
 
 
18
 
19
- If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
20
- forums](https://discuss.streamlit.io).
 
 
 
 
 
1
+ # 🎬 Movie Recommendation System
2
+
3
+ This is a **content-based movie recommender** built using **Python, Streamlit, and Hugging Face Spaces**.
4
+ It suggests movies similar to your favorite film using cosine similarity on movie metadata.
5
+
6
+ ## πŸš€ Features
7
+ - Search any movie from the dataset
8
+ - Get 5 similar movie recommendations instantly
9
+ - Interactive web app powered by Streamlit
 
 
 
 
10
 
11
+ ## πŸ›  Tech Stack
12
+ - **Python 3.9**
13
+ - **Pandas**, **NumPy** for data processing
14
+ - **Scikit-learn** for cosine similarity
15
+ - **Streamlit** for UI
16
+ - Hosted on **Hugging Face Spaces**
17
 
18
+ ## πŸ“‚ Dataset
19
+ The app uses:
20
+ - `tmdb_5000_movies.csv`
21
+ - `tmdb_5000_credits.csv`
22
+ (from [Kaggle TMDB Movie Dataset](https://www.kaggle.com/datasets/tmdb/tmdb-movie-metadata)).
23
+
24
+ ## πŸ”— Live Demo
25
+ πŸ‘‰ [**Try the App Here**](https://huggingface.co/spaces/akashraut/RECOMMENDATION_SYSTEM)
26
+
27
+ ---
28
 
29
+ ### How to Run Locally
30
+ ```bash
31
+ git clone https://huggingface.co/spaces/akashraut/RECOMMENDATION_SYSTEM
32
+ cd RECOMMENDATION_SYSTEM
33
+ pip install -r requirements.txt
34
+ streamlit run app.py