Skip to content

Prerequisites

Before starting, ensure you have the following accounts and tools ready.

Required accounts

Account Purpose Sign up
Okahu Trace storage and evaluations portal.okahu.co
OpenAI or Google Cloud LLM provider for the ADK agent (use one) platform.openai.com / cloud.google.com
GitHub CI/CD workflows and issue tracking github.com

Required tools

Fork the repository

GitHub Actions workflows can only be triggered by the repository owner. Fork the demo repo into your own GitHub account:

  1. Go to okahu-demos/adk-travel-agent-with-cicd
  2. Click Fork in the top-right corner
  3. Select your GitHub account as the destination

  4. Clone your fork locally:

    git clone https://github.com/<your-username>/adk-travel-agent-with-cicd.git
cd adk-travel-agent-with-cicd

Repository secrets

Configure these as Repository secrets in your fork under Settings → Secrets and variables → Actions:

Secret Purpose
OKAHU_API_KEY Okahu API authentication
OKAHU_INGESTION_ENDPOINT Trace ingestion endpoint
CICD_OKAHU_APP_NAME Application identifier in Okahu
OPENAI_API_KEY OpenAI API key (takes priority over Google if set)
OPENAI_MODEL OpenAI model override (optional, default: gpt-3.5-turbo)
GOOGLE_API_KEY Gemini API key (used if OPENAI_API_KEY is not set)
GOOGLE_GENAI_MODEL Gemini model name (e.g., gemini-2.5-flash-lite)
GOOGLE_GENAI_USE_VERTEXAI Whether to use Vertex AI (e.g., FALSE)
GOOGLE_CLOUD_PROJECT Google Cloud project ID (required for Vertex AI)
GOOGLE_CLOUD_LOCATION Google Cloud region (required for Vertex AI)
MONOCLE_EXPORTER Monocle exporter configuration
GH_PAT GitHub personal access token for issue creation and Claude assignment

Environment secrets

When Claude investigates issues via the GitHub Agents tab, it runs inside the copilot environment and reads secrets from there. Configure these under Settings → Environments → copilot:

Secret Purpose
CICD_OKAHU_APP_NAME Application identifier in Okahu
GOOGLE_API_KEY Gemini API key
GOOGLE_GENAI_USE_VERTEXAI Whether to use Vertex AI
MONOCLE_EXPORTER Monocle exporter configuration
OKAHU_API_KEY Okahu API authentication
OKAHU_INGESTION_ENDPOINT Trace ingestion endpoint
OPENAI_API_KEY OpenAI API key
OPENAI_MODEL OpenAI model override (optional, default: gpt-3.5-turbo)

Local development

For running tests locally, create a .env.test file with these variables. The test configuration in conftest.py loads this file automatically.