# googlecloudplatform/agent-starter-pack architecture

> Architecture diagram of the GitHub repository googlecloudplatform/agent-starter-pack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/googlecloudplatform/agent-starter-pack
- Repository: https://github.com/googlecloudplatform/agent-starter-pack

## Overview

Agent Starter Pack is a Python CLI and catalog of production-oriented agent project templates for Google Cloud. Its main workflow is to create or enhance a project, selecting an agent, language, and deployment target; template utilities materialize and merge the project, which can then use agent-specific runtime, RAG ingestion, and deployment scaffolding. The README also documents CI/CD setup, remote templates, evaluation/playground capabilities, and observability. The sampled source confirms CLI dispatch and RAG pipeline wiring; other branches are included from the README and tree, with uncertain implementation links omitted.

Main entry points: [`agent_starter_pack/cli/utils/template.py`](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/utils/template.py) (Template engine), [`agent_starter_pack/cli/main.py`](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/main.py) (CLI entry), [`agent_starter_pack/cli/commands/create.py`](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/create.py) (Create project), [`agent_starter_pack/cli/commands/enhance.py`](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/enhance.py) (Enhance project)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Project CLI"]
  node_cli_entry["CLI entry<br/>[main.py]"]
  node_create["Create project<br/>[create.py]"]
  node_enhance["Enhance project<br/>[enhance.py]"]
  node_template_engine["Template engine<br/>[template.py]"]
  node_remote_templates["Remote templates<br/>[remote_template.py]"]
  node_merge["Template merging<br/>[merge.py]"]
  node_agent_catalog["Agent catalog<br/>[list.py]"]
  node_extract["Extract agent<br/>[extract.py]"]
end

subgraph group_templates["Agent Templates"]
  node_base_python["Python base runtime<br/>[typing.py]"]
  node_adk_agents["ADK agent variants<br/>[agent.py]"]
  node_a2a_agent["A2A agent<br/>[agent.py]"]
  node_rag_agent["RAG retrieval<br/>[retrievers.py]"]
  node_ingestion_orchestrator["Ingestion pipeline<br/>[pipeline.py]"]
  node_process_data["Data processing<br/>[process_data.py]"]
  node_ingest_data["Vector ingestion<br/>[ingest_data.py]"]
  node_cloud_ingestion[("Cloud data stores")]
  node_live_agent["Live agent<br/>[agent.py]"]
end

subgraph group_operations["Cloud Operations"]
  node_cicd_setup["CI/CD setup<br/>[setup_cicd.py]"]
  node_cicd_utils["CI/CD configuration<br/>[cicd.py]"]
  node_enterprise["Enterprise registration"]
  node_deployment_targets["Deployment adapters"]
  node_agent_engine["Agent Engine app"]
  node_cloud_run["Cloud Run app<br/>[fast_api_app.py]"]
  node_gke["GKE app<br/>[fast_api_app.py]"]
end

subgraph group_live["Live Experience"]
  node_live_ui["Live chat UI<br/>[App.tsx]"]
  node_live_context["Live API context<br/>[LiveAPIContext.tsx]"]
  node_live_hook["Live API hook<br/>[use-live-api.ts]"]
  node_live_client["Multimodal client"]
  node_live_panel["Media controls<br/>[SidePanel.tsx]"]
end

node_user(("Project developer"))

node_user -->|"runs"| node_cli_entry
node_cli_entry -->|"dispatches"| node_create
node_cli_entry -->|"dispatches"| node_enhance
node_cli_entry -->|"dispatches"| node_agent_catalog
node_create -->|"uses"| node_template_engine
node_create -->|"uses"| node_remote_templates
node_enhance -->|"uses"| node_template_engine
node_enhance -->|"merges"| node_merge
node_enhance -->|"reuses"| node_create
node_template_engine -->|"resolves"| node_remote_templates
node_user -->|"configures"| node_cicd_setup
node_cli_entry -->|"dispatches"| node_cicd_setup
node_cicd_setup -->|"configures"| node_cicd_utils
node_cli_entry -->|"dispatches"| node_enterprise
node_create -.->|"generates"| node_base_python
node_template_engine -.->|"materializes"| node_adk_agents
node_template_engine -.->|"materializes"| node_a2a_agent
node_template_engine -.->|"materializes"| node_rag_agent
node_ingestion_orchestrator -->|"runs"| node_process_data
node_ingestion_orchestrator -->|"runs"| node_ingest_data
node_ingest_data -.->|"writes chunks"| node_cloud_ingestion
node_template_engine -.->|"includes"| node_deployment_targets
node_deployment_targets -.->|"offers"| node_agent_engine
node_deployment_targets -.->|"offers"| node_cloud_run
node_deployment_targets -.->|"offers"| node_gke
node_live_ui -->|"uses"| node_live_context
node_live_context -->|"calls"| node_live_hook
node_live_hook -->|"uses"| node_live_client
node_live_panel -->|"consumes"| node_live_context
node_template_engine -.->|"materializes"| node_live_agent
node_live_client -.->|"connects"| node_live_agent

click node_cli_entry "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/main.py"
click node_create "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/create.py"
click node_enhance "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/enhance.py"
click node_template_engine "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/utils/template.py"
click node_remote_templates "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/utils/remote_template.py"
click node_merge "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/utils/merge.py"
click node_agent_catalog "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/list.py"
click node_extract "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/extract.py"
click node_cicd_setup "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/setup_cicd.py"
click node_cicd_utils "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/utils/cicd.py"
click node_enterprise "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/register_gemini_enterprise.py"
click node_base_python "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/base_templates/python/%7B%7Bcookiecutter.agent_directory%7D%7D/app_utils/typing.py"
click node_adk_agents "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/adk/app/agent.py"
click node_a2a_agent "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/adk_a2a/app/agent.py"
click node_rag_agent "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/agentic_rag/app/retrievers.py"
click node_ingestion_orchestrator "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/pipeline.py"
click node_process_data "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/components/process_data.py"
click node_ingest_data "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/components/ingest_data.py"
click node_cloud_ingestion "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/agentic_rag/deployment/terraform/scripts/setup_data_connector.py"
click node_deployment_targets "https://github.com/googlecloudplatform/agent-starter-pack/tree/main/agent_starter_pack/deployment_targets"
click node_agent_engine "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/deployment_targets/agent_engine/python/%7B%7Bcookiecutter.agent_directory%7D%7D/agent_engine_app.py"
click node_cloud_run "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/deployment_targets/cloud_run/python/%7B%7Bcookiecutter.agent_directory%7D%7D/fast_api_app.py"
click node_gke "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/deployment_targets/gke/python/%7B%7Bcookiecutter.agent_directory%7D%7D/fast_api_app.py"
click node_live_ui "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/frontends/adk_live_react/frontend/src/App.tsx"
click node_live_context "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/frontends/adk_live_react/frontend/src/contexts/LiveAPIContext.tsx"
click node_live_hook "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/frontends/adk_live_react/frontend/src/hooks/use-live-api.ts"
click node_live_client "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/frontends/adk_live_react/frontend/src/utils/multimodal-live-client.ts"
click node_live_panel "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/frontends/adk_live_react/frontend/src/components/side-panel/SidePanel.tsx"
click node_live_agent "https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/adk_live/app/agent.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli_entry,node_create,node_enhance,node_template_engine,node_remote_templates,node_merge,node_agent_catalog,node_extract toneBlue
class node_base_python,node_adk_agents,node_a2a_agent,node_rag_agent,node_ingestion_orchestrator,node_process_data,node_ingest_data,node_cloud_ingestion,node_live_agent toneAmber
class node_cicd_setup,node_cicd_utils,node_enterprise,node_deployment_targets,node_agent_engine,node_cloud_run,node_gke toneMint
class node_live_ui,node_live_context,node_live_hook,node_live_client,node_live_panel toneRose
class node_user toneIndigo
```

## Components

### Project CLI

- [CLI entry](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/main.py): `agent_starter_pack/cli/main.py`
- [Create project](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/create.py): `agent_starter_pack/cli/commands/create.py`
- [Enhance project](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/enhance.py): `agent_starter_pack/cli/commands/enhance.py`
- [Template engine](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/utils/template.py): `agent_starter_pack/cli/utils/template.py`
- [Remote templates](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/utils/remote_template.py): `agent_starter_pack/cli/utils/remote_template.py`
- [Template merging](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/utils/merge.py): `agent_starter_pack/cli/utils/merge.py`
- [Agent catalog](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/list.py): `agent_starter_pack/cli/commands/list.py`
- [Extract agent](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/extract.py): `agent_starter_pack/cli/commands/extract.py`

### Agent Templates

- [Python base runtime](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/base_templates/python/%7B%7Bcookiecutter.agent_directory%7D%7D/app_utils/typing.py): `agent_starter_pack/base_templates/python/{{cookiecutter.agent_directory}}/app_utils/typing.py`
- [ADK agent variants](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/adk/app/agent.py): `agent_starter_pack/agents/adk/app/agent.py`
- [A2A agent](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/adk_a2a/app/agent.py): `agent_starter_pack/agents/adk_a2a/app/agent.py`
- [RAG retrieval](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/agentic_rag/app/retrievers.py): `agent_starter_pack/agents/agentic_rag/app/retrievers.py`
- [Ingestion pipeline](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/pipeline.py): `agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/pipeline.py`
- [Data processing](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/components/process_data.py): `agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/components/process_data.py`
- [Vector ingestion](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/components/ingest_data.py): `agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/components/ingest_data.py`
- [Cloud data stores](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/agentic_rag/deployment/terraform/scripts/setup_data_connector.py): `agent_starter_pack/agents/agentic_rag/deployment/terraform/scripts/setup_data_connector.py`
- [Live agent](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/agents/adk_live/app/agent.py): `agent_starter_pack/agents/adk_live/app/agent.py`

### Cloud Operations

- [CI/CD setup](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/setup_cicd.py): `agent_starter_pack/cli/commands/setup_cicd.py`
- [CI/CD configuration](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/utils/cicd.py): `agent_starter_pack/cli/utils/cicd.py`
- [Enterprise registration](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/cli/commands/register_gemini_enterprise.py): `agent_starter_pack/cli/commands/register_gemini_enterprise.py`
- [Deployment adapters](https://github.com/googlecloudplatform/agent-starter-pack/tree/main/agent_starter_pack/deployment_targets): `agent_starter_pack/deployment_targets`
- [Agent Engine app](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/deployment_targets/agent_engine/python/%7B%7Bcookiecutter.agent_directory%7D%7D/agent_engine_app.py): `agent_starter_pack/deployment_targets/agent_engine/python/{{cookiecutter.agent_directory}}/agent_engine_app.py`
- [Cloud Run app](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/deployment_targets/cloud_run/python/%7B%7Bcookiecutter.agent_directory%7D%7D/fast_api_app.py): `agent_starter_pack/deployment_targets/cloud_run/python/{{cookiecutter.agent_directory}}/fast_api_app.py`
- [GKE app](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/deployment_targets/gke/python/%7B%7Bcookiecutter.agent_directory%7D%7D/fast_api_app.py): `agent_starter_pack/deployment_targets/gke/python/{{cookiecutter.agent_directory}}/fast_api_app.py`

### Live Experience

- [Live chat UI](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/frontends/adk_live_react/frontend/src/App.tsx): `agent_starter_pack/frontends/adk_live_react/frontend/src/App.tsx`
- [Live API context](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/frontends/adk_live_react/frontend/src/contexts/LiveAPIContext.tsx): `agent_starter_pack/frontends/adk_live_react/frontend/src/contexts/LiveAPIContext.tsx`
- [Live API hook](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/frontends/adk_live_react/frontend/src/hooks/use-live-api.ts): `agent_starter_pack/frontends/adk_live_react/frontend/src/hooks/use-live-api.ts`
- [Multimodal client](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/frontends/adk_live_react/frontend/src/utils/multimodal-live-client.ts): `agent_starter_pack/frontends/adk_live_react/frontend/src/utils/multimodal-live-client.ts`
- [Media controls](https://github.com/googlecloudplatform/agent-starter-pack/blob/main/agent_starter_pack/frontends/adk_live_react/frontend/src/components/side-panel/SidePanel.tsx): `agent_starter_pack/frontends/adk_live_react/frontend/src/components/side-panel/SidePanel.tsx`

### Other components

- **Project developer**

## Connections

- Project developer → CLI entry: runs
- CLI entry → Create project: dispatches (evidence: `agent_starter_pack/cli/main.py`)
- CLI entry → Enhance project: dispatches (evidence: `agent_starter_pack/cli/main.py`)
- CLI entry → Agent catalog: dispatches (evidence: `agent_starter_pack/cli/main.py`)
- Create project → Template engine: uses (evidence: `agent_starter_pack/cli/commands/create.py`)
- Create project → Remote templates: uses (evidence: `agent_starter_pack/cli/commands/create.py`)
- Enhance project → Template engine: uses (evidence: `agent_starter_pack/cli/commands/enhance.py`)
- Enhance project → Template merging: merges (evidence: `agent_starter_pack/cli/commands/enhance.py`)
- Enhance project → Create project: reuses (evidence: `agent_starter_pack/cli/commands/enhance.py`)
- Template engine → Remote templates: resolves (evidence: `agent_starter_pack/cli/utils/template.py`)
- Project developer → CI/CD setup: configures
- CLI entry → CI/CD setup: dispatches (evidence: `agent_starter_pack/cli/main.py`)
- CI/CD setup → CI/CD configuration: configures (evidence: `agent_starter_pack/cli/commands/setup_cicd.py`)
- CLI entry → Enterprise registration: dispatches (evidence: `agent_starter_pack/cli/main.py`)
- Create project → Python base runtime: generates
- Template engine → ADK agent variants: materializes
- Template engine → A2A agent: materializes
- Template engine → RAG retrieval: materializes
- Ingestion pipeline → Data processing: runs (evidence: `agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/pipeline.py`)
- Ingestion pipeline → Vector ingestion: runs (evidence: `agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/pipeline.py`)
- Vector ingestion → Cloud data stores: writes chunks
- Template engine → Deployment adapters: includes
- Deployment adapters → Agent Engine app: offers
- Deployment adapters → Cloud Run app: offers
- Deployment adapters → GKE app: offers
- Live chat UI → Live API context: uses (evidence: `agent_starter_pack/frontends/adk_live_react/frontend/src/App.tsx`)
- Live API context → Live API hook: calls (evidence: `agent_starter_pack/frontends/adk_live_react/frontend/src/contexts/LiveAPIContext.tsx`)
- Live API hook → Multimodal client: uses (evidence: `agent_starter_pack/frontends/adk_live_react/frontend/src/hooks/use-live-api.ts`)
- Media controls → Live API context: consumes (evidence: `agent_starter_pack/frontends/adk_live_react/frontend/src/components/side-panel/SidePanel.tsx`)
- Template engine → Live agent: materializes
- Multimodal client → Live agent: connects
