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
Google Cloud	Gemini API for the ADK agent	cloud.google.com
GitHub	CI/CD workflows and issue tracking	github.com

Required tools

• Python 3.11+
• Git
• VS Code with the Okahu extension (optional)

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
CICD_OKAHU_APP_NAME	Application identifier in Okahu
GOOGLE_API_KEY	Gemini API key
GOOGLE_GENAI_MODEL	Model name (e.g., gemini-2.5-flash-lite)
GOOGLE_GENAI_USE_VERTEXAI	Whether to use Vertex AI (e.g., FALSE)
MONOCLE_EXPORTER	Monocle exporter configuration
OKAHU_API_KEY	Okahu API authentication
OKAHU_INGESTION_ENDPOINT	Trace ingestion endpoint

Environment secrets

If your workflow uses the copilot environment (for AI agent assignment), also 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

Local development

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