Zebra668/movie-recommender

🎬 CineRec — Movie Recommendation System

S-Class cinematic movie recommender with 3 AI strategies + sentiment analysis.

Tech Stack

3 Recommendation Strategies

1. 1.Content-Based — Genre, keywords, cast se similar movies
2. 2.Collaborative Filtering — User ratings ke pattern se
3. 3.Hybrid — Dono ka combination (best results)

🚀 Deploy Steps

Step 1: Backend → Hugging Face Spaces

1. 1.HuggingFace pe new Space banao
2. 2.SDK: Docker
3. 3.Name: movie-recommender
4. 4.Visibility: Public

1. 1.backend/ folder ki sab files upload karo

1. 1.Space Settings → Secrets mein add karo:

   TMDB_API_KEY = f2c65dbd4b13d7dda8b7bb8ae95448b4

1. 1.Space automatically build ho jaayega
2. 2.URL milegi: https://YOUR-USERNAME-movie-recommender.hf.space

Step 2: Frontend → GitHub Pages

1. 1.GitHub pe new repo banao: movie-recommender-frontend

1. 1.frontend/ folder ki sab files upload karo

1. 1.app.js mein line 4 update karo:

   const API_BASE = "https://YOUR-HF-USERNAME-movie-recommender.hf.space";

1. 1.GitHub repo Settings → Pages → Branch: main → Save

1. 1.URL milegi: https://YOUR-GITHUB-USERNAME.github.io/movie-recommender-frontend

Project Structure

backend/
├── main.py          ← FastAPI routes
├── recommender.py   ← 3 ML strategies
├── sentiment.py     ← Review sentiment
├── database.py      ← SQLite
├── tmdb.py          ← TMDB API helper
├── requirements.txt
└── Dockerfile

frontend/
├── index.html       ← Home page
├── movie.html       ← Movie detail + reviews + recommendations
├── style.css        ← Cinematic dark gold design
└── app.js           ← All frontend logic

Features

• —✅ Live movie data + posters from TMDB
• —✅ 3 recommendation strategies with tab switcher
• —✅ Post-watch recommendations banner
• —✅ Star rating + text review system
• —✅ Automatic sentiment analysis (positive/negative/neutral)
• —✅ Sentiment visualization bars
• —✅ Movie search with live dropdown
• —✅ Genre filter chips
• —✅ Hero banner with auto-rotation
• —✅ Skeleton loading states
• —✅ Responsive design (mobile friendly)
• —✅ Watch history tracking
• —✅ Personalized recommendations per user