🎬 FESTIVY — Music Festival YouTube Jukebox Agent

FESTIVY is a next-generation, frictionless agentic web application built using the google-genai SDK and Vertex AI Gemini 3.1 Pro (gemini-3.1-pro-preview). It multimodally parses music festival poster images to extract artist lineups, streams real-time processing logs directly to the web frontend, and programmatically generates a beautiful, interactive cards grid. Clicking on any card launches an unauthenticated YouTube embedded video search player playing that artist's signature track immediately.

With zero configuration overhead, no complex OAuth logins, and unauthenticated YouTube embeds, FESTIVY is fully optimized for high-availability workshop environments.

---

🛠️ Prerequisites and Credentials Setup

To run the Jukebox, you need to configure Google Cloud Platform (GCP) to allow the GenAI client to communicate with the Vertex AI Prediction service.

1. Enable Google Cloud Vertex AI API

1. Select Your GCP Project:

   • Open the Google Cloud Console.
   • Select or create your active project.

2. Enable the Vertex AI API:

   • In the top search bar, type Vertex AI API and select it.
   • Click Enable to activate the aiplatform.googleapis.com prediction service for your project.

---

2. Local Authentication Setup (Application Default Credentials)

Since enterprise and corporate organization policies often block the use of API keys with Vertex AI services, we recommend authenticating using Application Default Credentials (ADC).

1. Run the ADC login command in your terminal:

   gcloud auth application-default login

2. Authenticate: A browser window will open asking you to sign in with your Google account. Once approved, a secure credentials JSON file will be saved locally on your machine (e.g., ~/.config/gcloud/application_default_credentials.json).
3. The google-genai SDK will automatically pick up this local credentials file to authorize requests securely!

---

⚙️ Local Configuration & Installation

1. Set Environment Variables

Open the local app/.env file and define your parameters:

# Disable API keys to enforce secure Application Default Credentials (ADC) authentication
# GEMINI_API_KEY=

# GCP project and regional endpoint configurations
GCP_PROJECT=lee-experimental
GCP_LOCATION=global

# Server address settings
HOST=127.0.0.1
PORT=8080
CACHE_FILE_PATH=data/festival_cache.json

2. Install Dependencies and Run the App

Ensure you have uv installed on your system, then run:

# Initialize virtual environment & install dependencies
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

# Start the application server
python run.py

Once running, open your browser and navigate to http://127.0.0.1:8080.

---

🎨 Example Festival Poster Image

When running or testing the agent, you can download or use this high-fidelity music festival poster to verify multimodal parsing:

• Download Festival Poster URL: https://cdn.shopify.com/s/files/1/0689/6061/6685/files/20251104_Download26_1.jpg?v=1762242348