WatchPath

WatchPath is an AI-powered YouTube skill path discovery dashboard.

Stack

• Frontend: Next.js
• Backend: FastAPI
• Database: PostgreSQL + pgvector
• AI: OpenAI-only pipeline

Quick Start

One-command startup (Windows)

start.bat

start.bat behavior:

• Uses Docker + PostgreSQL on localhost:5433 when Docker daemon is available.
• Falls back to SQLite (backend/watchpath.db) automatically when Docker is unavailable.
• Starts backend (:8010) and frontend (:3001) in separate terminal windows.
• Creates backend/.env.bak backup on each run before startup.

Manual startup

1. Start PostgreSQL:

docker compose -f infra/docker-compose.yml up -d

2. Backend:

cd backend
pip install -e .
copy .env.example .env
uvicorn app.main:app --reload --port 8010

Note: WatchPath Postgres is exposed on localhost:5433 to avoid conflicts with other local projects.

3. Frontend:

cd frontend
npm install
npm run dev  # serves on http://localhost:3001

API

Base URL: http://localhost:8010/api/v1

For local development, call:

• GET /api/v1/auth/google/callback?code=dev-code

Use the returned user_id as X-User-Id for authenticated routes.