2025-09-09 18:12:57 +02:00

1.5 KiB

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

Setup

  1. Get YouTube 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