yutu/internal/tools/skillgen/setup.md

Yutu Setup Guide

Before using any yutu skill, you need to install yutu and configure YouTube API credentials.

Prerequisites

An account on Google Cloud Platform is required. Set up the following:

1. Create a GCP Project and enable these APIs under APIs & Services -> Enable APIs and services:

   • YouTube Data API v3 (Required)
   • YouTube Analytics API (Optional)
   • YouTube Reporting API (Optional)

2. Create OAuth credentials:

   • Go to APIs & Services -> OAuth consent screen, create a consent screen with yourself as a test user
   • Go to Credentials -> Create Credentials -> OAuth Client ID, select Web Application
   • Add http://localhost:8216 as an authorized redirect URI
   • Download the credential file and save it as client_secret.json

3. Authenticate:

   yutu auth --credential client_secret.json
   

   A browser window will open for you to grant YouTube access. After granting permission, a token is saved to youtube.token.json.

Installation

Install yutu using one of these methods:

# Node.js (all platforms)
npm i -g @eat-pray-ai/yutu

# macOS
brew install yutu

# Linux
brew install yutu

# Windows
winget install yutu

# Gopher
go install github.com/eat-pray-ai/yutu@latest

Other platforms

Download a prebuilt binary from the releases page and place it in your PATH.

Environment Variables

Variable	Description	Default
YUTU_CREDENTIAL	Path, base64, or JSON of OAuth client secret	client_secret.json
YUTU_CACHE_TOKEN	Path, base64, or JSON of cached OAuth token	youtube.token.json
YUTU_ROOT	Root directory for file resolution	Current working directory
YUTU_LOG_LEVEL	Log level: DEBUG, INFO, WARN, ERROR	INFO

For more details, see the yutu README.