Skip to content

README.md

Latest commit

 

History

History
118 lines (81 loc) · 2.64 KB

README.md

File metadata and controls

118 lines (81 loc) · 2.64 KB

🔥 FireFind - AI-Powered Entertainment Discovery

FireFind is an intelligent content recommendation system that uses AI to analyze your mood, context, and preferences to suggest the perfect entertainment.

🚀 Features

  • AI Mood Analysis: Automatically detects mood from movie descriptions
  • Real-time Context: Weather and time-based recommendations
  • Smart Recommendations: ML-powered content matching
  • Watch Party: Share viewing experiences with friends
  • Beautiful UI: Modern, responsive design

🛠️ Tech Stack

  • Frontend: HTML, CSS, JavaScript
  • Backend: AWS Lambda, API Gateway
  • AI/ML: AWS Bedrock (Claude), Custom Mood Analysis
  • Database: DynamoDB
  • APIs: OMDb (movies), OpenWeatherMap (weather)

📋 Prerequisites

🔧 Installation

  1. Clone the repository:
git clone https://github.com/yourusername/firefind.git
cd firefind
  1. Copy configuration templates:
cp config.example.js config.js
cp .env.example .env
  1. Edit config.js and add your API keys:
window.APP_CONFIG = {
    OMDB_API_KEY: 'your_actual_key_here',
    OPENWEATHER_API_KEY: 'your_actual_key_here',
    # ... other config
};
  1. Install backend dependencies:
cd backend/lambdas/prompt-processor && npm install
cd ../recommendation-engine && npm install
cd ../context-collector && npm install
cd ../watch-party && npm install

🚀 Deployment

🖥️ Frontend Deployment

  1. Update config.js with production values
    Replace API keys and URLs with production-ready values in config.js.

  2. Deploy to a static hosting service
    Options include:

☁️ Backend Deployment

  1. Set up AWS credentials
aws configure
  1. Deploy Lambda functions
cd backend
./deploy.sh
  1. Create API Gateway and update the URL in config.js

💻 Local Development

  • Open index.html in a web browser
  • The app will use mock data by default
  • To use real APIs, update USE_MOCK_DATA to false in config.js

🔒 Security Notes

  • Never commit API keys to GitHub
  • Use environment variables for sensitive data
  • In production, implement backend proxy for API calls

👥 Team

  • Rishika Agarwal
  • Prernendu Bhagat
  • Mansa Mahendru

IIIT Allahabad | Amazon HackOn 5.0