Documentation

Everything you need to deploy, operate, and extend Sympozium on Google Cloud.

Getting Started

Quick Start
Install Sympozium on GKE in 5 minutes
Prerequisites
GKE cluster, gcloud, Helm 3
Workload Identity Setup
Keyless auth configuration

Architecture

Platform Overview
Components, CRDs, and data flow
Model Tier System
Fast, Balanced, Powerful, Local
Hybrid Inference
Vertex AI + self-hosted Gemma
Event Bus (Pub/Sub)
Agent IPC via Cloud Pub/Sub

Concepts

Custom Resources
SympoziumInstance, PersonaPack, SkillPack, AgentRun
Personas
Agent roles, system prompts, model tier mapping
Skills & Sidecars
Tool containers, RBAC, resource limits
Channels
Google Chat, Discord integrations
Policies
Admission control, model/tool/network policies

Guides

Observability
Cloud Monitoring vs Prometheus/Grafana paths
Writing Skills
Create custom tool sidecars
Deploying This Showcase
Run the full showcase on your own GKE cluster

Reference

Helm Values
Full chart configuration reference
API Server
REST API endpoints
Cloud Build Pipeline
CI/CD configuration

Deploy This Showcase

Run the full Sympozium showcase — platform, Grafana, and this site — on your own GKE cluster.


# Clone the repo
git clone https://github.com/geoffsdesk/sympozium.git
cd sympozium/showcase

# Set your config
export GCP_PROJECT=your-project-id
export DOMAIN=sympozium.yourdomain.dev
export GCP_REGION=us-central1

# Deploy everything
./scripts/deploy.sh

This reserves a static IP, builds the showcase site via Cloud Build, installs Sympozium via Helm with GMP enabled, deploys Grafana with the pre-built dashboard, and creates a GKE Ingress with Google-managed TLS. Takes about 10 minutes.