Skip to content

README.md

Latest commit

 

History

History
76 lines (56 loc) · 1.79 KB

README.md

File metadata and controls

76 lines (56 loc) · 1.79 KB
Raw

PopcornPicks

PopcornPicks is a movie recommender web app built with Streamlit. Select a movie you like and get personalized recommendations with detailed information and posters.

Features

  • Movie selection from a curated list
  • Top 5 similar movie recommendations
  • Movie details: overview, genres, rating, release date, runtime, and poster
  • Direct links to TMDb pages

Project Structure

.
├── app.py                # Main Streamlit app
├── requirements.txt      # Python dependencies
├── setup.sh              # Heroku setup script
├── procfile              # Heroku process file
├── .slugignore           # Heroku slugignore file
├── assets/
│   └── more_info.jpg     # Fallback image
├── models/
│   ├── movies_dict.pkl   # Movie metadata
│   └── similarity.pkl    # Similarity matrix
└── ml-model-training/    # Model training notebooks and data (not deployed)

Getting Started

Local Development

  1. Clone the repository

    git clone <repo-url>
cd movie-recommender-app

  2. Install dependencies

    pip install -r requirements.txt

  3. Run the app

    streamlit run app.py

Deploy on Heroku

  1. Ensure you have a Heroku account and the Heroku CLI installed.

  2. Login to Heroku

    heroku login

  3. Create a new Heroku app

    heroku create your-app-name

  4. Deploy

    git push heroku main

Notes

  • The ml-model-training folder contains Jupyter notebooks and raw data for model building. It is excluded from deployment.
  • The app uses precomputed model files in the models/ directory.

License

This project is for educational purposes.