agent-starter-pack 0.15.7__tar.gz → 0.17.0__tar.gz

{agent_starter_pack-0.15.7 → agent_starter_pack-0.17.0}/.claude/settings.local.json

@@ -15,7 +15,19 @@
       "Bash(uv run ruff check tests/cli/utils/test_remote_template.py)",
       "Bash(uv run pytest tests/cli/utils/test_remote_template.py -v)",
       "Bash(uv run pytest tests/integration/test_pipeline_parity.py::test_staging_parity -v -s)",
-      "Bash(python3 -c \"from vertexai.agent_engines._agent_engines import AgentEngine; import inspect; print([m for m in dir(AgentEngine) if not m.startswith(''_'')])\")"
+      "Bash(python3 -c \"from vertexai.agent_engines._agent_engines import AgentEngine; import inspect; print([m for m in dir(AgentEngine) if not m.startswith(''_'')])\")",
+      "Bash(python tests/cicd/scripts/delete_agent_engines.py)",
+      "Bash(python tests/cicd/scripts/delete_alloydb_clusters.py)",
+      "Bash(python tests/cicd/scripts/delete_service_accounts.py)",
+      "Bash(python tests/cicd/scripts/delete_vector_search.py)",
+      "Bash(python3 tests/cicd/scripts/delete_alloydb_clusters.py)",
+      "Bash(python3 tests/cicd/scripts/delete_service_accounts.py)",
+      "Bash(python3 tests/cicd/scripts/delete_vector_search.py)",
+      "Bash(PROJECT_IDS=agent-starter-pack-e2e-dev,agent-starter-pack-e2e-st,agent-starter-pack-e2e-pr python3 tests/cicd/scripts/delete_agent_engines.py)",
+      "Bash(export _TEST_AGENT_COMBINATION=adk_live,agent_engine)",
+      "Bash(make lint-templated-agents)",
+      "Bash(mkdir -p agent-starter-pack)",
+      "Bash(ls -la \"agent_starter_pack/base_template/{% if cookiecutter.cicd_runner == ''google_cloud_build'' %}.cloudbuild{% else %}unused_.cloudbuild{% endif %}/\")"
     ],
     "deny": [],
     "ask": []

{agent_starter_pack-0.15.7 → agent_starter_pack-0.17.0}/.cloudbuild/ci/lint.yaml

@@ -32,7 +32,7 @@ steps:
         set -e
         uv run ruff check . --config pyproject.toml --diff
         uv run ruff format . --check  --config pyproject.toml --diff
-        uv run mypy --config-file pyproject.toml ./src/cli ./tests ./src/frontends/streamlit
+        uv run mypy --config-file pyproject.toml ./agent_starter_pack/cli ./tests ./agent_starter_pack/frontends/streamlit
 
 logsBucket: gs://${PROJECT_ID}-logs-data/build-logs
 options:

{agent_starter_pack-0.15.7 → agent_starter_pack-0.17.0}/.cloudbuild/ci/test_templated_agents.yaml

@@ -35,4 +35,4 @@ logsBucket: gs://${PROJECT_ID}-logs-data/build-logs
 options:
   defaultLogsBucketBehavior: REGIONAL_USER_OWNED_BUCKET
   env:
-    - "_TEST_AGENT_COMBINATION=live_api,cloud_run"
+    - "_TEST_AGENT_COMBINATION=${_TEST_AGENT_COMBINATION}"

agent_starter_pack-0.17.0/.cloudbuild/terraform/backend.tf

@@ -0,0 +1,6 @@
+terraform {
+  backend "gcs" {
+    bucket = "agent-starter-pack-cicd-terraform-state"
+    prefix = "cloudbuild"
+  }
+}

{agent_starter_pack-0.15.7 → agent_starter_pack-0.17.0}/.cloudbuild/terraform/build_triggers.tf

@@ -23,33 +23,33 @@ locals {
   ]
 
   common_included_files = [
-    "agents/**",
-    "src/cli/**",
+    "agent_starter_pack/agents/**",
+    "agent_starter_pack/cli/**",
     "tests/**",
-    "src/data_ingestion/**",
-    "src/frontends/streamlit/**",
+    "agent_starter_pack/data_ingestion/**",
+    "agent_starter_pack/frontends/streamlit/**",
     "pyproject.toml",
     "uv.lock",
     ".cloudbuild/**",
   ]
 
   lint_templated_agents_included_files = [
-    "src/cli/**",
-    "src/base_template/**",
-    "src/data_ingestion/**",
-    "src/deployment_targets/**",
+    "agent_starter_pack/cli/**",
+    "agent_starter_pack/base_template/**",
+    "agent_starter_pack/data_ingestion/**",
+    "agent_starter_pack/deployment_targets/**",
     "tests/integration/test_template_linting.py",
     "tests/integration/test_templated_patterns.py",
-    "src/resources/locks/**",
+    "agent_starter_pack/resources/locks/**",
     "pyproject.toml",
     "uv.lock",
     ".cloudbuild/**",
   ]
 
   makefile_usability_included_files = [
-    "src/cli/**",
-    "src/base_template/**",
-    "src/deployment_targets/**",
+    "agent_starter_pack/cli/**",
+    "agent_starter_pack/base_template/**",
+    "agent_starter_pack/deployment_targets/**",
     "tests/integration/test_makefile_usability.py",
     "pyproject.toml",
     "uv.lock",
@@ -91,15 +91,19 @@ locals {
       value = "agentic_rag,cloud_run,--include-data-ingestion,--datastore,vertex_ai_vector_search"
     },
     {
-      name  = "live_api-cloud_run"
-      value = "live_api,cloud_run"
+      name  = "adk_live-agent_engine"
+      value = "adk_live,agent_engine"
+    },
+    {
+      name  = "adk_live-cloud_run"
+      value = "adk_live,cloud_run"
     },
     {
       name  = "adk_base-cloud_run-alloydb"
       value = "adk_base,cloud_run,--session-type,alloydb"
     },
     {
-      name  = "adk_base-cloud_run-agent_engine"
+      name  = "adk_b-cr-agent_engine"
       value = "adk_base,cloud_run,--session-type,agent_engine"
     },
   ]
@@ -107,14 +111,14 @@ locals {
 agent_testing_included_files = { for combo in local.agent_testing_combinations :
     combo.name => [
       # Only include files for the specific agent being tested
-      "agents/${split(",", combo.value)[0]}/**",
+      "agent_starter_pack/agents/${split(",", combo.value)[0]}/**",
       # Common files that affect all agents
-      "src/cli/**",
-      "src/base_template/**",
-      "src/deployment_targets/**",
+      "agent_starter_pack/cli/**",
+      "agent_starter_pack/base_template/**",
+      "agent_starter_pack/deployment_targets/**",
       "tests/integration/test_template_linting.py",
       "tests/integration/test_templated_patterns.py",
-      "src/resources/locks/**",
+      "agent_starter_pack/resources/locks/**",
       "pyproject.toml",
       "uv.lock",
     ]
@@ -132,6 +136,10 @@ agent_testing_included_files = { for combo in local.agent_testing_combinations :
       name = "agentic_rag-agent_engine-vertex_ai_search-github"
       value = "agentic_rag,agent_engine,--include-data-ingestion,--datastore,vertex_ai_search,--cicd-runner,github_actions"
     },
+    {
+      name  = "adk_live-agent_engine-github"
+      value = "adk_live,agent_engine,--cicd-runner,github_actions"
+    },
     {
       name  = "adk_base-agent_engine"
       value = "adk_base,agent_engine,-dir,tag"
@@ -153,8 +161,12 @@ agent_testing_included_files = { for combo in local.agent_testing_combinations :
       value = "agentic_rag,cloud_run,--include-data-ingestion,--datastore,vertex_ai_vector_search"
     },
     {
-      name  = "live_api-cloud_run"
-      value = "live_api,cloud_run"
+      name  = "adk_live-agent_engine"
+      value = "adk_live,agent_engine"
+    },
+    {
+      name  = "adk_live-cloud_run"
+      value = "adk_live,cloud_run"
     },
     {
       name  = "adk_base-cloud_run-alloydb"
@@ -174,25 +186,25 @@ agent_testing_included_files = { for combo in local.agent_testing_combinations :
 
   e2e_agent_deployment_included_files = { for combo in local.e2e_agent_deployment_combinations :
     combo.name => combo.name == "adk_base-cloud_run-alloydb" ? [
-      "src/deployment_targets/cloud_run/**",
+      "agent_starter_pack/deployment_targets/cloud_run/**",
       "pyproject.toml",
     ] : substr(combo.name, 0, 11) == "agentic_rag" ? [
-      "agents/agentic_rag/**",
-      "src/data_ingestion/**",
+      "agent_starter_pack/agents/agentic_rag/**",
+      "agent_starter_pack/data_ingestion/**",
       "pyproject.toml",
-    ] : substr(combo.name, 0, 8) == "live_api" ? [
-      "agents/live_api/**",
+    ] : substr(combo.name, 0, 8) == "adk_live" ? [
+      "agent_starter_pack/agents/adk_live/**",
       "pyproject.toml",
     ] : [
       # Only include files for the specific agent being tested
-      "agents/${split(",", combo.value)[0]}/**",
+      "agent_starter_pack/agents/${split(",", combo.value)[0]}/**",
       # Common files that affect all agents
-      "src/cli/**",
-      "src/base_template/**",
-      "src/data_ingestion/**",
-      "src/deployment_targets/**",
+      "agent_starter_pack/cli/**",
+      "agent_starter_pack/base_template/**",
+      "agent_starter_pack/data_ingestion/**",
+      "agent_starter_pack/deployment_targets/**",
       "tests/cicd/test_e2e_deployment.py",
-      "src/resources/locks/**",
+      "agent_starter_pack/resources/locks/**",
       "pyproject.toml",
       "uv.lock",
       ".cloudbuild"
@@ -414,10 +426,10 @@ resource "google_cloudbuild_trigger" "pr_test_pipeline_parity" {
   filename       = ".cloudbuild/ci/test_pipeline_parity.yaml"
   included_files = [
     "tests/integration/test_pipeline_parity.py",
-    "src/cli/**",
+    "agent_starter_pack/cli/**",
     ".cloudbuild/**",
-    "src/base_template/**/.github/**",
-    "src/base_template/**/.cloudbuild/**",
+    "agent_starter_pack/base_template/**/.github/**",
+    "agent_starter_pack/base_template/**/.cloudbuild/**",
     "pyproject.toml",
     "uv.lock",
   ]

agent_starter_pack-0.17.0/.cloudbuild/terraform/vars/env.tfvars

@@ -0,0 +1,13 @@
+cicd_runner_project_id = "agent-starter-pack-cicd"
+
+region = "europe-west4"
+
+host_connection_name = "git-connection"
+
+repository_name = "GoogleCloudPlatform-agent-starter-pack"
+
+e2e_test_project_mapping = {
+  dev     = "agent-starter-pack-e2e-dev"
+  staging = "agent-starter-pack-e2e-st"
+  prod    = "agent-starter-pack-e2e-pr"
+}

{agent_starter_pack-0.15.7 → agent_starter_pack-0.17.0}/.gitignore

@@ -195,8 +195,6 @@ target
 set_projects.sh
 delete_genai_repos.sh
 cleanup_e2e_projects.sh
-.cloudbuild/terraform/backend.tf
-.cloudbuild/terraform/vars/env.tfvars
 docs/.vitepress/cache
 tests/cicd/delete_gcp_resources.sh
 tests/cicd/delete_agent_engines.py

{agent_starter_pack-0.15.7 → agent_starter_pack-0.17.0}/GEMINI.md

@@ -7,8 +7,8 @@ This document provides essential guidance, architectural insights, and best prac
 1.  **Preserve and Isolate:** Your primary objective is surgical precision. Modify *only* the code segments directly related to the user's request. Preserve all surrounding code, comments, and formatting. Do not rewrite entire files or functions to make a small change.
 2.  **Follow Conventions:** This project relies heavily on established patterns. Before writing new code, analyze the surrounding files to understand and replicate existing conventions for naming, templating logic, and directory structure.
 3.  **Search Comprehensively:** A single change often requires updates in multiple places. When modifying configuration, variables, or infrastructure, you **must** search across the entire repository, including:
-    *   `src/base_template/` (the core template)
-    *   `src/deployment_targets/` (environment-specific overrides)
+    *   `agent-starter-pack/base_template/` (the core template)
+    *   `agent-starter-pack/deployment_targets/` (environment-specific overrides)
     *   `.github/` and `.cloudbuild/` (CI/CD workflows)
     *   `docs/` (user-facing documentation)
 
@@ -28,10 +28,10 @@ Templates are processed in a specific order. A failure at any stage will break t
 
 ### Key Directory Structures
 
--   `src/base_template/`: This is the **core template**. Most changes that should apply to all generated projects should start here.
--   `src/deployment_targets/`: Contains files that **override or are added to** the `base_template` for a specific deployment target (e.g., `cloud_run`, `gke`, `agent_engine`). If a file exists in both `base_template` and a deployment target, the latter is typically used.
--   `agents/`: Contains pre-packaged, self-contained agent examples. Each has its own `.template/templateconfig.yaml` to define its specific variables and dependencies.
--   `src/cli/commands`: Contains the logic for the CLI commands, such as `create` and `setup-cicd`.
+-   `agent-starter-pack/base_template/`: This is the **core template**. Most changes that should apply to all generated projects should start here.
+-   `agent-starter-pack/deployment_targets/`: Contains files that **override or are added to** the `base_template` for a specific deployment target (e.g., `cloud_run`, `gke`, `agent_engine`). If a file exists in both `base_template` and a deployment target, the latter is typically used.
+-   `agent-starter-pack/agents/`: Contains pre-packaged, self-contained agent examples. Each has its own `.template/templateconfig.yaml` to define its specific variables and dependencies.
+-   `agent-starter-pack/cli/commands`: Contains the logic for the CLI commands, such as `create` and `setup-cicd`.
 
 ### CLI Commands
 
@@ -40,7 +40,7 @@ Templates are processed in a specific order. A failure at any stage will break t
 
 ### Template Processing
 
--   `template.py`: Located in `src/cli/utils`, this script contains the core logic for processing the templates. It copies the base template, overlays the deployment target files, and then applies the agent-specific files.
+-   `template.py`: Located in `agent-starter-pack/cli/utils`, this script contains the core logic for processing the templates. It copies the base template, overlays the deployment target files, and then applies the agent-specific files.
 
 ## Critical Jinja Templating Rules
 
@@ -118,10 +118,10 @@ When adding a new variable or secret, ensure it is configured correctly for both
 
 ### 4-Layer Architecture
 Template processing follows this hierarchy (later layers override earlier ones):
-1. **Base Template** (`src/base_template/`) - Applied to ALL projects
-2. **Deployment Targets** (`src/deployment_targets/`) - Environment overrides  
-3. **Frontend Types** (`src/frontends/`) - UI-specific files
-4. **Agent Templates** (`agents/*/`) - Individual agent logic
+1. **Base Template** (`agent-starter-pack/base_template/`) - Applied to ALL projects
+2. **Deployment Targets** (`agent-starter-pack/deployment_targets/`) - Environment overrides  
+3. **Frontend Types** (`agent-starter-pack/frontends/`) - UI-specific files
+4. **Agent Templates** (`agent-starter-pack/agents/*/`) - Individual agent logic
 
 **Rule**: Always place changes in the correct layer. Check if deployment targets need corresponding updates.
 
@@ -139,7 +139,7 @@ Changes often require coordinated updates:
 
 ### Conditional Logic Patterns
 ```jinja
-{%- if cookiecutter.agent_name == "live_api" %}
+{%- if cookiecutter.agent_name == "adk_live" %}
 # Agent-specific logic
 {%- elif cookiecutter.deployment_target == "cloud_run" %}
 # Deployment-specific logic  
@@ -148,7 +148,7 @@ Changes often require coordinated updates:
 
 ### Testing Strategy
 Test changes across multiple dimensions:
-- Agent types (live_api, adk_base, etc.)
+- Agent types (adk_live, adk_base, etc.)
 - Deployment targets (cloud_run, agent_engine)
 - Feature combinations (data_ingestion, frontend_type)
 - Example command for testing the starter pack creation - from the root of the repo run: `uv run agent-starter-pack create myagent-$(date +%s) --output-dir target`
@@ -156,7 +156,7 @@ Test changes across multiple dimensions:
 ### Common Pitfalls
 - **Hardcoded URLs**: Use relative paths for frontend connections
 - **Missing Conditionals**: Wrap agent-specific code in proper `{% if %}` blocks
-- **Dependency Conflicts**: Some agents lack certain extras (e.g., live_api + lint)
+- **Dependency Conflicts**: Some agents lack certain extras (e.g., adk_live + lint)
 
 ## File Modification Checklist
 

{agent_starter_pack-0.15.7 → agent_starter_pack-0.17.0}/Makefile

@@ -8,13 +8,13 @@ test-e2e:
 	set -a && . tests/cicd/.env && set +a && uv run pytest tests/cicd/test_e2e_deployment.py -v
 
 generate-lock:
-	uv run src/utils/generate_locks.py
+	uv run python -m agent_starter_pack.utils.generate_locks
 
 lint:
 	uv sync --dev --extra lint
 	uv run ruff check . --config pyproject.toml --diff
 	uv run ruff format . --check  --config pyproject.toml --diff
-	uv run mypy --config-file pyproject.toml ./src/cli ./tests ./src/frontends/streamlit
+	uv run mypy --config-file pyproject.toml ./agent_starter_pack/cli ./tests ./agent_starter_pack/frontends/streamlit
 
 lint-templated-agents:
 	uv run tests/integration/test_template_linting.py

{agent_starter_pack-0.15.7 → agent_starter_pack-0.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.15.7
+Version: 0.17.0
 Summary: CLI to bootstrap production-ready Google Cloud GenAI agent projects from templates.
 Author-email: Google LLC <agent-starter-pack@google.com>
 License: Apache-2.0
@@ -9,7 +9,7 @@ Requires-Python: >=3.10
 Requires-Dist: backoff>=2.2.1
 Requires-Dist: click>=8.1.7
 Requires-Dist: cookiecutter<3.0.0,>=2.6.0
-Requires-Dist: google-cloud-aiplatform>=1.87.0
+Requires-Dist: google-cloud-aiplatform>=1.120.0
 Requires-Dist: pyyaml>=6.0.1
 Requires-Dist: rich>=13.7.0
 Requires-Dist: tomli>=1.1.0; python_version < '3.11'
@@ -39,20 +39,28 @@ Description-Content-Type: text/markdown
   </picture>
 </a> [![Launch in Cloud Shell](https://img.shields.io/badge/Launch-in_Cloud_Shell-white)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Feliasecchig%2Fasp-open-in-cloud-shell&cloudshell_print=open-in-cs) ![Stars](https://img.shields.io/github/stars/GoogleCloudPlatform/agent-starter-pack?color=yellow)
 
+A Python package that provides **production-ready templates** for GenAI agents on Google Cloud.
 
-The `agent-starter-pack` is a Python package that provides a collection of production-ready Generative AI Agent templates built for Google Cloud. <br>
-It accelerates development by providing a holistic, production-ready solution, addressing common challenges (Deployment & Operations, Evaluation, Customization, Observability) in building and deploying GenAI agents.
+Focus on your agent logic—the starter pack provides everything else: infrastructure, CI/CD, observability, and security.
 
 | ⚡️ Launch | 🧪 Experiment  | ✅ Deploy | 🛠️ Customize |
 |---|---|---|---|
 | [Pre-built agent templates](./agents/) (ReAct, RAG, multi-agent, Live API). | [Vertex AI evaluation](https://cloud.google.com/vertex-ai/generative-ai/docs/models/evaluation-overview) and an interactive playground. | Production-ready infra with [monitoring, observability](https://googlecloudplatform.github.io/agent-starter-pack/guide/observability), and [CI/CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/deployment) on [Cloud Run](https://cloud.google.com/run) or [Agent Engine](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview). | Extend and customize templates according to your needs. 🆕 Now integrating with [Gemini CLI](https://github.com/google-gemini/gemini-cli) |
 
 ---
- 
+
 ## ⚡ Get Started in 1 Minute
 
-Ready to build your AI agent? Simply run this command:
+**From zero to production-ready agent in 60 seconds using [`uv`](https://docs.astral.sh/uv/getting-started/installation/):**
+
+```bash
+uvx agent-starter-pack create my-awesome-agent
+```
+
+<details>
+<summary> ✨ Alternative: Using pip</summary>
 
+If you don't have [`uv`](https://github.com/astral-sh/uv) installed, you can use pip:
 ```bash
 # Create and activate a Python virtual environment
 python -m venv .venv && source .venv/bin/activate
@@ -63,15 +71,6 @@ pip install --upgrade agent-starter-pack
 # Create a new agent project
 agent-starter-pack create my-awesome-agent
 ```
-
-<details>
-<summary> ✨ Alternative: Using uv</summary>
-
-If you have [`uv`](https://github.com/astral-sh/uv) installed, you can create and set up your project with a single command:
-```bash
-uvx agent-starter-pack create my-awesome-agent
-```
-This command handles creating the project without needing to pre-install the package into a virtual environment.
 </details>
 
 **That's it!** You now have a fully functional agent project—complete with backend, frontend, and deployment infrastructure—ready for you to explore and customize.
@@ -96,7 +95,7 @@ See [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pac
 | `agentic_rag` | A RAG agent for document retrieval and Q&A. Supporting [Vertex AI Search](https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction) and [Vector Search](https://cloud.google.com/vertex-ai/docs/vector-search/overview).       |
 | `langgraph_base_react`      | An agent implementing a base ReAct agent using LangGraph |
 | `crewai_coding_crew`       | A multi-agent system implemented with CrewAI created to support coding activities       |
-| `live_api`       | A real-time multimodal RAG agent powered by Gemini, supporting audio/video/text chat with vector DB-backed responses                       |
+| `adk_live`       | A real-time multimodal RAG agent powered by Gemini, supporting audio/video/text chat     |
 
 **More agents are on the way!** We are continuously expanding our [agent library](https://googlecloudplatform.github.io/agent-starter-pack/agents/overview). Have a specific agent type in mind? [Raise an issue as a feature request!](https://github.com/GoogleCloudPlatform/agent-starter-pack/issues/new?labels=enhancement)
 
@@ -112,9 +111,9 @@ Explore amazing projects built with the Agent Starter Pack!
 
 **[View Community Showcase →](https://googlecloudplatform.github.io/agent-starter-pack/guide/community-showcase)**
 
-#### Extra Features
+## Key Features
 
-The `agent-starter-pack` offers two key features to accelerate and simplify the development of your agent:
+The `agent-starter-pack` offers key features to accelerate and simplify the development of your agent:
 - **🔄 [CI/CD Automation](https://googlecloudplatform.github.io/agent-starter-pack/cli/setup_cicd)** - A single command to set up a complete CI/CD pipeline for all environments, supporting both **Google Cloud Build** and **GitHub Actions**.
 - **📥 [Data Pipeline for RAG with Terraform/CI-CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/data-ingestion)** - Seamlessly integrate a data pipeline to process embeddings for RAG into your agent system. Supporting [Vertex AI Search](https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction) and [Vector Search](https://cloud.google.com/vertex-ai/docs/vector-search/overview).
 - **[Remote Templates](docs/guide/remote-templating.md)**: Create and share your own agent starter packs templates from any Git repository.

{agent_starter_pack-0.15.7 → agent_starter_pack-0.17.0}/README.md

@@ -15,20 +15,28 @@
   </picture>
 </a> [![Launch in Cloud Shell](https://img.shields.io/badge/Launch-in_Cloud_Shell-white)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Feliasecchig%2Fasp-open-in-cloud-shell&cloudshell_print=open-in-cs) ![Stars](https://img.shields.io/github/stars/GoogleCloudPlatform/agent-starter-pack?color=yellow)
 
+A Python package that provides **production-ready templates** for GenAI agents on Google Cloud.
 
-The `agent-starter-pack` is a Python package that provides a collection of production-ready Generative AI Agent templates built for Google Cloud. <br>
-It accelerates development by providing a holistic, production-ready solution, addressing common challenges (Deployment & Operations, Evaluation, Customization, Observability) in building and deploying GenAI agents.
+Focus on your agent logic—the starter pack provides everything else: infrastructure, CI/CD, observability, and security.
 
 | ⚡️ Launch | 🧪 Experiment  | ✅ Deploy | 🛠️ Customize |
 |---|---|---|---|
 | [Pre-built agent templates](./agents/) (ReAct, RAG, multi-agent, Live API). | [Vertex AI evaluation](https://cloud.google.com/vertex-ai/generative-ai/docs/models/evaluation-overview) and an interactive playground. | Production-ready infra with [monitoring, observability](https://googlecloudplatform.github.io/agent-starter-pack/guide/observability), and [CI/CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/deployment) on [Cloud Run](https://cloud.google.com/run) or [Agent Engine](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview). | Extend and customize templates according to your needs. 🆕 Now integrating with [Gemini CLI](https://github.com/google-gemini/gemini-cli) |
 
 ---
- 
+
 ## ⚡ Get Started in 1 Minute
 
-Ready to build your AI agent? Simply run this command:
+**From zero to production-ready agent in 60 seconds using [`uv`](https://docs.astral.sh/uv/getting-started/installation/):**
+
+```bash
+uvx agent-starter-pack create my-awesome-agent
+```
+
+<details>
+<summary> ✨ Alternative: Using pip</summary>
 
+If you don't have [`uv`](https://github.com/astral-sh/uv) installed, you can use pip:
 ```bash
 # Create and activate a Python virtual environment
 python -m venv .venv && source .venv/bin/activate
@@ -39,15 +47,6 @@ pip install --upgrade agent-starter-pack
 # Create a new agent project
 agent-starter-pack create my-awesome-agent
 ```
-
-<details>
-<summary> ✨ Alternative: Using uv</summary>
-
-If you have [`uv`](https://github.com/astral-sh/uv) installed, you can create and set up your project with a single command:
-```bash
-uvx agent-starter-pack create my-awesome-agent
-```
-This command handles creating the project without needing to pre-install the package into a virtual environment.
 </details>
 
 **That's it!** You now have a fully functional agent project—complete with backend, frontend, and deployment infrastructure—ready for you to explore and customize.
@@ -72,7 +71,7 @@ See [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pac
 | `agentic_rag` | A RAG agent for document retrieval and Q&A. Supporting [Vertex AI Search](https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction) and [Vector Search](https://cloud.google.com/vertex-ai/docs/vector-search/overview).       |
 | `langgraph_base_react`      | An agent implementing a base ReAct agent using LangGraph |
 | `crewai_coding_crew`       | A multi-agent system implemented with CrewAI created to support coding activities       |
-| `live_api`       | A real-time multimodal RAG agent powered by Gemini, supporting audio/video/text chat with vector DB-backed responses                       |
+| `adk_live`       | A real-time multimodal RAG agent powered by Gemini, supporting audio/video/text chat     |
 
 **More agents are on the way!** We are continuously expanding our [agent library](https://googlecloudplatform.github.io/agent-starter-pack/agents/overview). Have a specific agent type in mind? [Raise an issue as a feature request!](https://github.com/GoogleCloudPlatform/agent-starter-pack/issues/new?labels=enhancement)
 
@@ -88,9 +87,9 @@ Explore amazing projects built with the Agent Starter Pack!
 
 **[View Community Showcase →](https://googlecloudplatform.github.io/agent-starter-pack/guide/community-showcase)**
 
-#### Extra Features
+## Key Features
 
-The `agent-starter-pack` offers two key features to accelerate and simplify the development of your agent:
+The `agent-starter-pack` offers key features to accelerate and simplify the development of your agent:
 - **🔄 [CI/CD Automation](https://googlecloudplatform.github.io/agent-starter-pack/cli/setup_cicd)** - A single command to set up a complete CI/CD pipeline for all environments, supporting both **Google Cloud Build** and **GitHub Actions**.
 - **📥 [Data Pipeline for RAG with Terraform/CI-CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/data-ingestion)** - Seamlessly integrate a data pipeline to process embeddings for RAG into your agent system. Supporting [Vertex AI Search](https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction) and [Vector Search](https://cloud.google.com/vertex-ai/docs/vector-search/overview).
 - **[Remote Templates](docs/guide/remote-templating.md)**: Create and share your own agent starter packs templates from any Git repository.

{agent_starter_pack-0.15.7 → agent_starter_pack-0.17.0/agent_starter_pack}/agents/adk_base/.template/templateconfig.yaml

@@ -18,7 +18,7 @@ settings:
   requires_data_ingestion: false
   requires_session: true
   deployment_targets: ["agent_engine", "cloud_run"]
-  extra_dependencies: ["google-adk~=1.14.0"]
+  extra_dependencies: ["google-adk>=1.15.0,<2.0.0"]
   tags: ["adk"]
   frontend_type: "None"
     

{agent_starter_pack-0.15.7/agents/live_api → agent_starter_pack-0.17.0/agent_starter_pack/agents/adk_live}/.template/templateconfig.yaml

@@ -12,13 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-description: "A real-time multimodal RAG agent powered by Gemini Live API, supporting audio/video/text chat with vector DB-backed responses"
+description: "Real-time multimodal agent with ADK and Gemini Live API for low-latency voice and video interaction."
 settings:
   requires_data_ingestion: false
-  frontend_type: "live_api_react"
-  deployment_targets: ["cloud_run"]
-  extra_dependencies: [
-    "backoff~=2.2.1",
-    "google-genai>=1.16.0",
-  ]
+  frontend_type: "adk_live_react"
+  deployment_targets: ["agent_engine", "cloud_run"]
+  extra_dependencies: ["google-adk>=1.16.0,<2.0.0", "click>=8.0.0,<9.0.0", "uvicorn>=0.18.0,<1.0.0", "fastapi>=0.75.0,<1.0.0", "backoff>=2.0.0,<3.0.0"]
+  tags: ["adk", "adk_live"]
 example_question: "What's the weather in San Francisco?"

agent_starter_pack-0.17.0/agent_starter_pack/agents/adk_live/README.md

@@ -0,0 +1,32 @@
+# ADK Live Agent
+
+Real-time conversational agent built with Google ADK and Gemini's live audio model. Supports audio, video, and text interactions with native tool calling.
+
+![live_api_diagram](https://storage.googleapis.com/github-repo/generative-ai/sample-apps/e2e-gen-ai-app-starter-pack/live_api_diagram.png)
+
+**Key components:**
+
+- **Python Backend** (in `app/` folder): ADK-powered agent using Gemini's live audio model with native tool calling and deployment support for Cloud Run and Agent Engine
+
+- **React Frontend** (in `frontend/` folder): Web console for interacting with the live agent via audio, video, and text
+
+![live api demo](https://storage.googleapis.com/github-repo/generative-ai/sample-apps/e2e-gen-ai-app-starter-pack/adk_live_pattern_demo.gif)
+
+Once running, click the play button to connect and interact with the agent. Try asking "What's the weather like in San Francisco?" to see tool calling in action.
+
+## Additional Resources for Multimodal Live API
+
+Explore these resources to learn more about the Multimodal Live API and see examples of its usage:
+
+- [Project Pastra](https://github.com/heiko-hotz/gemini-multimodal-live-dev-guide/tree/main): a comprehensive developer guide for the Gemini Multimodal Live API.
+- [ADK Samples: Realtime Conversational Agent](https://github.com/google/adk-samples/tree/main/python/agents/realtime-conversational-agent): Full-stack, reusable template using Agent Development Kit (ADK) with the Gemini Live API.
+- [Google Cloud Multimodal Live API demos and samples](https://github.com/GoogleCloudPlatform/generative-ai/tree/main/gemini/multimodal-live-api): Collection of code samples and demo applications leveraging multimodal live API in Vertex AI
+- [Gemini 2 Cookbook](https://github.com/google-gemini/cookbook/tree/main/gemini-2): Practical examples and tutorials for working with Gemini 2
+- [Multimodal Live API Web Console](https://github.com/google-gemini/multimodal-live-api-web-console): Interactive React-based web interface for testing and experimenting with Gemini Multimodal Live API.
+
+## Current Status & Future Work
+
+This pattern is under active development. Key areas planned for future enhancement include:
+
+*   **Observability:** Implementing comprehensive monitoring and tracing features.
+*   **Load Testing:** Integrating load testing capabilities.

agent_starter_pack-0.17.0/agent_starter_pack/agents/adk_live/app/agent.py

@@ -0,0 +1,48 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+import google.auth
+import vertexai
+from google.adk.agents import Agent
+
+_, project_id = google.auth.default()
+os.environ.setdefault("GOOGLE_CLOUD_PROJECT", project_id)
+os.environ.setdefault("GOOGLE_CLOUD_LOCATION", "us-central1")
+os.environ.setdefault("GOOGLE_GENAI_USE_VERTEXAI", "True")
+
+vertexai.init(project=project_id, location="us-central1")
+
+
+def get_weather(query: str) -> str:
+    """Simulates a web search. Use it get information on weather.
+
+    Args:
+        query: A string containing the location to get weather information for.
+
+    Returns:
+        A string with the simulated weather information for the queried location.
+    """
+    if "sf" in query.lower() or "san francisco" in query.lower():
+        return "It's 60 degrees and foggy."
+    return "It's 90 degrees and sunny."
+
+
+root_agent = Agent(
+    name="root_agent",
+    model="gemini-live-2.5-flash-preview-native-audio-09-2025",
+    instruction="You are a helpful AI assistant designed to provide accurate and useful information.",
+    tools=[get_weather],
+)