WatchWizards 🎬✨

WatchWizards is an AI-powered movie recommendation platform that helps users discover their perfect movie match. Whether you're looking for a solo movie night or planning a group watch party, WatchWizards uses advanced AI to curate personalized movie suggestions.

🌟 Features

Solo Mode

• Personalized movie recommendations based on user preferences
• AI-powered analysis of movie preferences
• Detailed movie information including ratings, cast, and plot
• Beautiful, intuitive user interface with magical animations
• Real-time movie data from TMDB API

Group Mode (Coming Soon)

• Create watch parties with friends
• Collaborative preference matching
• Group voting system
• Real-time synchronization
• Customizable group settings

🛠️ Tech Stack

• Frontend: Next.js 14, React, TypeScript
• Styling: Tailwind CSS, Framer Motion
• AI Integration: OpenAI GPT-4, Google AI
• Database: MongoDB
• Movie Data: TMDB API
• Deployment: Vercel

🚀 Development Journey

Key Challenges

1. AI Integration Complexity

   • Implementing multiple AI models for different recommendation types
   • Balancing response times with recommendation quality
   • Handling API rate limits and costs

2. Real-time Data Management

   • Synchronizing movie data across different sources
   • Managing API calls efficiently
   • Implementing caching strategies

3. User Experience

   • Creating an intuitive preference selection system
   • Designing smooth animations and transitions
   • Ensuring responsive design across devices

Key Wins

1. AI-Powered Recommendations

   • Successfully integrated multiple AI models
   • Achieved high accuracy in movie matching
   • Implemented efficient caching system

2. User Interface

   • Created a magical, engaging user experience
   • Implemented smooth animations and transitions
   • Built a responsive, accessible design

3. Performance

   • Optimized API calls and data fetching
   • Implemented efficient state management
   • Achieved fast load times and smooth interactions

🔮 Future Additions

Group Mode Features

• Real-time group synchronization
• Collaborative preference matching
• Group voting system
• Custom group settings
• Watch party scheduling
• Chat functionality

General Improvements

• Enhanced AI recommendation algorithms
• More detailed movie information
• Social sharing features
• User profiles and watch history
• Mobile app development
• Integration with streaming services

👥 Team (Solo production)

"Kobe, There's no I in team" - Shaquille O'Neal "But there's a me in that m#$" - Kobe Bryant

📞 Contact

• Website: [https://yaseensportfolio.vercel.app]
• Instagram: [https://www.instagram.com/yaleftonseen/]
• Email: [yaseenabdulaziz18@gmail.com]
• LinkedIn: [https://www.linkedin.com/in/mohammad-yaseen-abdul-aziz/]
• GitHub: [https://github.com/yaseenscodemuseum]

🎯 Getting Started

If you do use this repo, please do credit me or send me a photo of you using it on one of my socials.<> It'd make me really happy to see people appreciating my work.

1. Clone the repository

git clone https://github.com/yaseenscodemuseum/Watchwizards.git

2. Install dependencies

npm install

3. Set up environment variables

MONGODB_URI=your_mongodb_connection_string
TMDB_API_KEY=your_tmdb_api_key
OPENAI_API_KEY=your_openai_api_key
GOOGLE_AI_API_KEY=your_google_ai_api_key

4. Run the development server

npm run dev

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• TMDB for providing the movie database API
• OpenAI for GPT-4 integration
• Google AI for additional AI capabilities
• The open-source community for various tools and libraries

---

Made with alot of sweat, broken furniture and efforts by [Yaseen]