video-finder-algorithm/README.md

Video Inspiration Finder

AI-powered YouTube video recommendation system that learns your preferences.

Quick Start

./setup.sh

Select option 1 for web dashboard (recommended).

Requirements

• Python 3.7+
• YouTube Data API v3 Key from Google Cloud Console

Setup

1. Get YouTube API Key:

   • Visit Google Cloud Console
   • Create project and enable YouTube Data API v3
   • Create API key

2. Configure environment:

   cp .env.example .env
   # Edit .env and add your API key:
   # YOUTUBE_API_KEY=your_actual_api_key_here
   

3. Run setup:

   ./setup.sh
   

Web Dashboard

• Access at: http://localhost:5001
• YouTube-like interface with AI confidence scores
• Rate videos to train the AI model

Troubleshooting

Python not found: Use python3 instead of python

API Key Issues:

• Ensure YouTube Data API v3 is enabled
• Check your API key has quota remaining

Database Issues: Delete video_inspiration.db and run ./setup.sh again