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
   

Available Commands

# Interactive setup menu
./setup.sh

# Web dashboard
python3 dashboard_api.py

# CLI mode
python3 main.py

# Search for more videos
python3 search_more_videos.py

Web Dashboard

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

Manual Setup

If you prefer manual setup:

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install requests pandas scikit-learn numpy python-dotenv flask flask-cors

# Run dashboard
python3 dashboard_api.py

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