Your movie night assistant powered by collaborative filtering recommendations!

Are you spending more time picking a movie than actually watching one? Let StreamR solve your movie-night dilemma! Just let us know your preferences, and StreamR will recommend must-watch movies tailored just for you. 🍿🎬

• Overview
• Exciting Future Plans
• Demo Video
• How StreamR Works
• Tech Stack
• Setup and Installation
• Getting Started
• Documentation
• Join the Conversation
• Found a Bug?
• License

Welcome to StreamR! 🚀
Let us handle the hard part of picking a movie. Just provide your movie titles, and we'll curate a list of top recommendations perfect for your taste! 📽️
Save time and make every movie night a hit. StreamR delivers recommendations based on your unique preferences so you can focus on the popcorn! 🍿
Start your next great movie experience with a single click. 🎉

Our vision for StreamR includes:

1. Introducing more diverse genre, rating based recommendations.
2. Emailing users their latest recommendations for easy access.
3. Add multiple pages to go through more movies and reviews for search.
4. Enable sharing through social media and other options.
5. Add a subscribe option so that users can get emails according to their profile whenever a new movie is released.
6. Add an option for creating groups with shared watchlists.

StreamR can also be continuously tested with GitHub Actions, keeping our codebase rock-solid! 💪

Get a sneak peek of StreamR in action! Click the link to watch the demo.

Watch the demo video here

StreamR does more than just recommend movies. Here’s what’s under the hood:

• Analyzes movie characteristics like genre and user reviews to make informed suggestions.
• Combines movie features and user preferences using machine learning for truly personalized picks.
• Suggests trailers for your top recommendations so you can preview before you watch.
• Learns from feedback and improves recommendations with time.
• Lets you create an account, track movie history, add to watchlist, edit profile, and refine your recommendations.

To get started with StreamR:

• Python 3.5+
• pip
• Code Formatter - black pip install black
• Code Linter - Pylance (install it in VS Code)

After cloning, install dependencies with:

pip install -r requirements.txt

1. cd Code/recommenderapp
2. Run the application with:

   python3 app.py

3. Visit localhost:5000 in your browser to start exploring!

Check out the Wiki documentation for detailed information on how StreamR works and how to contribute.

We’d love to hear from you! Please open an issue if you find any bugs or have feature requests.

StreamR is open-source under the MIT License.

• We chose the MIT license to promote freedom and flexibility for you to adapt StreamR to your needs.
• Enjoy, share, and contribute back to the community!