Flixtogether

Personalized Group-Based Movie Recommendations
Bringing people together, one movie at a time.

---

📝 Table of Contents

• Problem Statement
• Solution
• Innovation and Impact
• Installation
• Future Scope
• Tech Stack
• Authors

🧐 Problem Statement

Picking a movie for a group with diverse tastes often turns into a lengthy, frustrating ordeal. Existing recommendation tools focus on individual preferences, neglecting the needs of group dynamics. Flixtogether steps in to simplify this by delivering a smart system that blends multiple user choices into tailored movie suggestions, complete with ratings and details.

💡 Solution

Flixtogether collects movie preferences from a group, runs them through a weighted recommendation algorithm, and proposes films that suit everyone’s tastes. Powered by the TMDb API, it fetches up-to-date movie info—including ratings and genres—ensuring groups can decide with confidence and ease.

👨‍💻 Innovation and Impact

Flixtogether sets itself apart with a collaborative filtering method designed for groups, not just individuals. By leveraging real-time TMDb ratings, it offers transparent, trustworthy recommendations. This streamlines the movie-picking process, enhancing social gatherings and making movie nights more enjoyable across a wide range of genres and preferences.

🛠️ Installation

Get Flixtogether up and running locally with these steps:

1. Clone the Repository

   git clone https://github.com/Dharshan2208/flixtogether.git
   cd flixtogether

2. Install Dependencies
   Ensure you have Node.js installed, then run:

   npm install

3. Set Up Environment Variables
   Create a .env file in the root directory and add your API keys:

   VITE_TMDB_API_KEY=your_tmdb_api_key_here
   VITE_GEMINI_API_KEY=your_gemini_api_key_here
   VITE_APPWRITE_PROJECT_ID=your_appwrite_project_id
   VITE_APPWRITE_DATABASE_ID=your_appwrite_database_id
   VITE_APPWRITE_COLLECTION_ID=your_appwrite_collection_id
   
   PORT=5000
   

4. Start the Development Server

   npm run dev

   Open your browser to http://localhost:5173 to see Flixtogether in action.

5. Build for Production (Optional)

   npm run build

   Preview the production build with:

   npm run preview

🚀 Future Scope

• User Feedback System: Allow users to rate suggestions for better accuracy.
• User Profiles: Save preferences for personalized experiences.
• Watch History: Tailor recommendations based on past selections.
• Streaming Integration: Connect to platforms like Netflix or Amazon Prime.

⛏️ Tech Stack

• React - Dynamic frontend library
• Vite - High-speed development server
• Tailwind CSS - Modern, responsive styling
• TMDb API - Real-time movie data
• Appwrite - Efficient database solution
• Node.js - Robust runtime environment
• Gemini API - AI-powered recommendations
• Vercel - Easy deployment platform

✍️ Authors

• Arham Garg
• Dharshan2208
• Jestifer Harold

---