How googlecloudplatform/agent-starter-pack works
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: template.py Template engine · main.py CLI entry · create.py Create project · enhance.py Enhance project
Components 30
Project CLI
- CLI entry
agent_starter_pack/cli/main.py - Create project
agent_starter_pack/cli/commands/create.py - Enhance project
agent_starter_pack/cli/commands/enhance.py - Template engine
agent_starter_pack/cli/utils/template.py - Remote templates
agent_starter_pack/cli/utils/remote_template.py - Template merging
agent_starter_pack/cli/utils/merge.py - Agent catalog
agent_starter_pack/cli/commands/list.py - Extract agent
agent_starter_pack/cli/commands/extract.py
Agent Templates
- Python base runtime
agent_starter_pack/base_templates/python/{{cookiecutter.agent_directory}}/app_utils/typing.py - ADK agent variants
agent_starter_pack/agents/adk/app/agent.py - A2A agent
agent_starter_pack/agents/adk_a2a/app/agent.py - RAG retrieval
agent_starter_pack/agents/agentic_rag/app/retrievers.py - Ingestion pipeline
agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/pipeline.py - Data processing
agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/components/process_data.py - Vector ingestion
agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/components/ingest_data.py - Cloud data stores
agent_starter_pack/agents/agentic_rag/deployment/terraform/scripts/setup_data_connector.py - Live agent
agent_starter_pack/agents/adk_live/app/agent.py
Cloud Operations
- CI/CD setup
agent_starter_pack/cli/commands/setup_cicd.py - CI/CD configuration
agent_starter_pack/cli/utils/cicd.py - Enterprise registration
agent_starter_pack/cli/commands/register_gemini_enterprise.py - Deployment adapters
agent_starter_pack/deployment_targets - Agent Engine app
agent_starter_pack/deployment_targets/agent_engine/python/{{cookiecutter.agent_directory}}/agent_engine_app.py - Cloud Run app
agent_starter_pack/deployment_targets/cloud_run/python/{{cookiecutter.agent_directory}}/fast_api_app.py - GKE app
agent_starter_pack/deployment_targets/gke/python/{{cookiecutter.agent_directory}}/fast_api_app.py
Live Experience
- Live chat UI
agent_starter_pack/frontends/adk_live_react/frontend/src/App.tsx - Live API context
agent_starter_pack/frontends/adk_live_react/frontend/src/contexts/LiveAPIContext.tsx - Live API hook
agent_starter_pack/frontends/adk_live_react/frontend/src/hooks/use-live-api.ts - Multimodal client
agent_starter_pack/frontends/adk_live_react/frontend/src/utils/multimodal-live-client.ts - Media controls
agent_starter_pack/frontends/adk_live_react/frontend/src/components/side-panel/SidePanel.tsx
Other components
- Project developer
Connections 31
- Project developer → CLI entry: runs
- CLI entry → Create project: dispatches
agent_starter_pack/cli/main.py - CLI entry → Enhance project: dispatches
agent_starter_pack/cli/main.py - CLI entry → Agent catalog: dispatches
agent_starter_pack/cli/main.py - Create project → Template engine: uses
agent_starter_pack/cli/commands/create.py - Create project → Remote templates: uses
agent_starter_pack/cli/commands/create.py - Enhance project → Template engine: uses
agent_starter_pack/cli/commands/enhance.py - Enhance project → Template merging: merges
agent_starter_pack/cli/commands/enhance.py - Enhance project → Create project: reuses
agent_starter_pack/cli/commands/enhance.py - Template engine → Remote templates: resolves
agent_starter_pack/cli/utils/template.py - Project developer → CI/CD setup: configures
- CLI entry → CI/CD setup: dispatches
agent_starter_pack/cli/main.py - CI/CD setup → CI/CD configuration: configures
agent_starter_pack/cli/commands/setup_cicd.py - CLI entry → Enterprise registration: dispatches
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
agent_starter_pack/agents/agentic_rag/data_ingestion/data_ingestion_pipeline/pipeline.py - Ingestion pipeline → Vector ingestion: runs
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
agent_starter_pack/frontends/adk_live_react/frontend/src/App.tsx - Live API context → Live API hook: calls
agent_starter_pack/frontends/adk_live_react/frontend/src/contexts/LiveAPIContext.tsx - Live API hook → Multimodal client: uses
agent_starter_pack/frontends/adk_live_react/frontend/src/hooks/use-live-api.ts - Media controls → Live API context: consumes
agent_starter_pack/frontends/adk_live_react/frontend/src/components/side-panel/SidePanel.tsx - Template engine → Live agent: materializes
- Multimodal client → Live agent: connects