agent-starter-pack 0.8.0__py3-none-any.whl → 0.9.0__py3-none-any.whl

{agent_starter_pack-0.8.0.dist-info → agent_starter_pack-0.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.8.0
+Version: 0.9.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
@@ -103,7 +103,8 @@ Looking to explore more ADK examples? Check out the [ADK Samples Repository](htt
 The `agent-starter-pack` offers two key features to accelerate and simplify the development of your agent:
 - **🔄 [CI/CD Automation (Experimental)](https://googlecloudplatform.github.io/agent-starter-pack/cli/setup_cicd)** - One command to set up a complete GitHub + Cloud Build pipeline for all environments
 - **📥 [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).
-* **🤖 Gemini CLI Integration** - Use the [Gemini CLI](https://github.com/google-gemini/gemini-cli) and the included `GEMINI.md` context file to ask questions about your template, agent architecture, and the path to production. Get instant guidance and code examples directly in your terminal.
+- **[Remote Templates](docs/guide/remote-templating.md)**: Create and share your own agent starter packs templates from any Git repository.
+- **🤖 Gemini CLI Integration** - Use the [Gemini CLI](https://github.com/google-gemini/gemini-cli) and the included `GEMINI.md` context file to ask questions about your template, agent architecture, and the path to production. Get instant guidance and code examples directly in your terminal.
 
 ## High-Level Architecture
 

{agent_starter_pack-0.8.0.dist-info → agent_starter_pack-0.9.0.dist-info}/RECORD

@@ -1,52 +1,52 @@
 agents/README.md,sha256=L8__lIXXjxLTZbkCmTC4taTFUMRVrO3QI2mCKZTdhJM,462
 agents/adk_base/README.md,sha256=eLf-F9Z4u_mQOchAnUaSrOAHXRSx8wUQN29kkwz1SF4,894
+agents/adk_base/.template/templateconfig.yaml,sha256=CUhOW807Ap2XDk3ZRK-OWP4-tD5fUUr8Nvv4yrOfjJk,923
 agents/adk_base/app/agent.py,sha256=6Q6QegQDxEaAck989DPIb3ArHMZtw_YJBqhHFqg-UjQ,2182
 agents/adk_base/notebooks/adk_app_testing.ipynb,sha256=wgFzBo7hX393NVzy3ZfZHncs1ptiQbM_8he3XxJu4yM,9763
 agents/adk_base/notebooks/evaluating_adk_agent.ipynb,sha256=OMTiT3gAFWPvE9pPL8z7tsDwOU-l8wem5wH-OXPPlvk,56805
-agents/adk_base/template/.templateconfig.yaml,sha256=VsyR_CmcOhFA3cLYiq-vLlvAxfM468hGGseIqWHKe-E,923
 agents/adk_base/tests/integration/test_agent.py,sha256=VypgpEWrQegJBgc58V-BlIsbqh-Hii-hwmkwcz5feFw,1969
 agents/adk_gemini_fullstack/README.md,sha256=yQFFcESALj5Q6eweyIyPx__U74obUM88aCBJYNV2UWs,1674
+agents/adk_gemini_fullstack/.template/templateconfig.yaml,sha256=gU0EeLdr2INQDZKeypofUoZw-lcwq3qV6E8AVeowTQg,1716
 agents/adk_gemini_fullstack/app/agent.py,sha256=NXOkYFxDccJaSq55CTS-UYY8z5-WgBZqexII0Ybzk9c,22662
 agents/adk_gemini_fullstack/app/config.py,sha256=x--axECPKWW3oLANKz2_4zzHEBIU7if8iYNZRjlTNV0,1563
 agents/adk_gemini_fullstack/notebooks/adk_app_testing.ipynb,sha256=wgFzBo7hX393NVzy3ZfZHncs1ptiQbM_8he3XxJu4yM,9763
 agents/adk_gemini_fullstack/notebooks/evaluating_adk_agent.ipynb,sha256=OMTiT3gAFWPvE9pPL8z7tsDwOU-l8wem5wH-OXPPlvk,56805
-agents/adk_gemini_fullstack/template/.templateconfig.yaml,sha256=MjLSQvi1Uq2No_pA9VfmiJfcTmJhRev3z8ByjLfcP6I,1683
 agents/adk_gemini_fullstack/tests/integration/test_agent.py,sha256=VypgpEWrQegJBgc58V-BlIsbqh-Hii-hwmkwcz5feFw,1969
 agents/agentic_rag/README.md,sha256=mxMLkq6tAghFaDmc2sc2sEQ5vn9kGWdiRxfTykwpLz0,2268
+agents/agentic_rag/.template/templateconfig.yaml,sha256=VC0Ss-QmLjROtSy3Dx_BSDV5xSgvr-yI1doBkKXBjc4,1248
 agents/agentic_rag/app/agent.py,sha256=tKtzez7vGu6JgMWmZN7QrKkyLBvHu1ondAuICjKoC-g,3983
 agents/agentic_rag/app/retrievers.py,sha256=qfxwSEixMddvAu4FvUTZAFh1Gdp3RPY65s0Wp6gEFVk,4561
 agents/agentic_rag/app/templates.py,sha256=8N_uRchwiN7hlH9Y8rdJ1CAtOhpHUWZkXZZ7IU-YJJk,867
 agents/agentic_rag/notebooks/adk_app_testing.ipynb,sha256=wgFzBo7hX393NVzy3ZfZHncs1ptiQbM_8he3XxJu4yM,9763
 agents/agentic_rag/notebooks/evaluating_adk_agent.ipynb,sha256=OMTiT3gAFWPvE9pPL8z7tsDwOU-l8wem5wH-OXPPlvk,56805
-agents/agentic_rag/template/.templateconfig.yaml,sha256=PMb7H913ZxGOhGzt4RPc2-QyzrOrycboh0ZZIHyk8Wg,1248
 agents/agentic_rag/tests/integration/test_agent.py,sha256=mxsKFyZrwXzIvAoxlqZv2JndM3VTVTKcugRYdF3APr4,2112
 agents/crewai_coding_crew/README.md,sha256=4No7sfHQVHELARGiT3fWANJzDR0NP48ow4ct3FoPwlA,1672
+agents/crewai_coding_crew/.template/templateconfig.yaml,sha256=q2KH2Hkq7MkGkVup9pIj2E3tosy7paQW2WiEHA2Qw_Y,1051
 agents/crewai_coding_crew/app/agent.py,sha256=yd-P2Jzx3Do4FQuhwDsok-YRNYFi9Vl8OTqSlbdn4Sw,3260
 agents/crewai_coding_crew/app/crew/crew.py,sha256=pqeeJ4txP-gcVT3PKEAw2zZ4x8g4cDlnFFbf0_zZRr4,2000
 agents/crewai_coding_crew/app/crew/config/agents.yaml,sha256=Cn9zTcP3C-8MvlV19cYdlxR0iIs2_FOy2gKOJLUpNRo,1154
 agents/crewai_coding_crew/app/crew/config/tasks.yaml,sha256=SSFuiSQPhi4dM0V5HdNuMqtN7JJr5RUCMhhBzUkPBpc,1511
 agents/crewai_coding_crew/notebooks/evaluating_crewai_agent.ipynb,sha256=ifTn4RfrJeYQ8ell9n6VE65ZEfcnKGkMLFG8RBlPK70,57974
 agents/crewai_coding_crew/notebooks/evaluating_langgraph_agent.ipynb,sha256=PlW41fL-ji9NKkimW6u25YRLGWN2pgoX2G8w5nzIEPE,58737
-agents/crewai_coding_crew/template/.templateconfig.yaml,sha256=q2KH2Hkq7MkGkVup9pIj2E3tosy7paQW2WiEHA2Qw_Y,1051
 agents/crewai_coding_crew/tests/integration/test_agent.py,sha256=0uvfmM3FSdESIU7ICb2oqABsQqylQU2PE3UBwbpif-A,1629
 agents/langgraph_base_react/README.md,sha256=KZQ0e8q9CqnIEiItH9Tc2Ceb2mC3sBcyQUo-ZAmO-zs,482
+agents/langgraph_base_react/.template/templateconfig.yaml,sha256=jHh3WDNT70KMbA2zy3Da_J_jIWeGfeiqIKfUs5B8OBk,1049
 agents/langgraph_base_react/app/agent.py,sha256=yzCc5JaOJgItoBiZOzHPiSy9aD2HGeGI_pH7nrysSmg,2505
 agents/langgraph_base_react/notebooks/evaluating_langgraph_agent.ipynb,sha256=PlW41fL-ji9NKkimW6u25YRLGWN2pgoX2G8w5nzIEPE,58737
-agents/langgraph_base_react/template/.templateconfig.yaml,sha256=jHh3WDNT70KMbA2zy3Da_J_jIWeGfeiqIKfUs5B8OBk,1049
 agents/langgraph_base_react/tests/integration/test_agent.py,sha256=wg2Y8V4l7dh7rhWy7Z8zioDW5ILRsz7RZJ-mz0AhK3U,1619
 agents/live_api/README.md,sha256=c3lu5WguOUBc5hO_UtNZfVhfYxvSzMXuGFICn9M38mU,2897
+agents/live_api/.template/templateconfig.yaml,sha256=DD_hihMsuqmd5VWS18vVGZ3ZGVVpFWVXJ2dU07eKb6k,964
 agents/live_api/app/agent.py,sha256=dYE2qd64OhL-fOgwzrjqN50LYXAgJ1TWbx6ohqtV5Rc,2434
 agents/live_api/app/server.py,sha256=ZXriNDl_zo7WDRBke85lyzMsy66qGzPaRXY1FMy4Fdw,7793
-agents/live_api/template/.templateconfig.yaml,sha256=DD_hihMsuqmd5VWS18vVGZ3ZGVVpFWVXJ2dU07eKb6k,964
 agents/live_api/tests/integration/test_server_e2e.py,sha256=D2VETDIyTD2fQyQ6DXwLr-POSYyVzzzcpIFLt5Ppyx4,8398
 agents/live_api/tests/load_test/load_test.py,sha256=HHZyfC4gqiQtZVF_CbbxENGgWQccMLpwMv0IdoQ6cbQ,1275
 agents/live_api/tests/unit/test_server.py,sha256=_TjlgQgNkjerIaBGnu8P8_KB8ZlSolDcivALpUOn_Rw,4786
 llm.txt,sha256=DZaO2YqDmvigYzqIvMsNPYilmbNqZfJL9hTicZHpvZc,13561
 src/base_template/.gitignore,sha256=Fq0w34x4sfbwP4RqDqh6hdHNYRUEsFNI-9XONzLWBIs,2580
 src/base_template/GEMINI.md,sha256=WzscHWlQeYkKORZ-453P8KM9IHuj1kAxW-69c7Ytuwk,133
-src/base_template/Makefile,sha256=037wvhexHIZyWW451D4vkvNnldTznxDFZ0sleUvl8jU,6115
+src/base_template/Makefile,sha256=MEsMvBosWrSVgUPRucTjsxYovl41rQc3d8Vw8dxdPoA,6128
 src/base_template/README.md,sha256=xAz5JXSnhCjXtvw5wSl6AVn6DJBlQIhSl4exyO5N4nc,10929
-src/base_template/pyproject.toml,sha256=ltiZufJ8BFbsRoWs2EcldWLzFd41du1YdAhldecwUfw,2874
+src/base_template/pyproject.toml,sha256=TEu9_gZT9tRuV6x8CcVIpC4Lcetbr0mHMPcJAab0aq4,2874
 src/base_template/app/__init__.py,sha256=UyAgc2l8nkVIUPUzL9hKR7EgzCsc2jSYcOcjHNNmpMU,59
 src/base_template/app/utils/gcs.py,sha256=jKblaWOGQEigw3esaawcfX178shhZi2Fyk0fJSA4T68,1501
 src/base_template/app/utils/tracing.py,sha256=2rv1Ukh2jTBENDwoghCItJ28l-Sjz9gMlzdojlVgJa4,6052
@@ -73,15 +73,17 @@ src/base_template/deployment/terraform/dev/variables.tf,sha256=7uQeqzN6IR14h1iTh
 src/base_template/deployment/terraform/dev/vars/env.tfvars,sha256=LoQMjh1AAMR-MGfaSCsVMjdoYTk2T4oS4D9vMH54CdQ,714
 src/base_template/deployment/terraform/vars/env.tfvars,sha256=Nze8q1x2Aj6ZUeWC2hDeZWqNUkLp13DgzA_LFmmOzCo,1216
 src/base_template/tests/unit/test_dummy.py,sha256=2exfCH8qhkZrLWvK04ZxNTO9MV3fdTbZkJN3uK6zvok,850
-src/cli/main.py,sha256=pMsSlNwkrFqHUHHA5U-WMZ4QRquaI_F7OXQt6yxuugE,1688
-src/cli/commands/create.py,sha256=PRqIu4fxgN3KCpzbiMC0jcghpsgt1LatShfvs2qP2xw,26396
+src/cli/main.py,sha256=fyJKjU1gvRQmuqS-J6sExvqXo0-z7n6Bce8PSbDPa6E,1769
+src/cli/commands/create.py,sha256=yIHngbbeUBvLKWg6IkH87yFwf-IJqdzbebkdqpwEFRQ,31818
+src/cli/commands/list.py,sha256=50sxEcYY5T4Q34Uj7J5h8A9Tq5Zw8GQhkqunBdzzD0U,5288
 src/cli/commands/setup_cicd.py,sha256=1ZvgTD-Z2bZk6pWuinz4IP2G1Eb8H1MibRLPS-mZ6Ng,31721
 src/cli/utils/__init__.py,sha256=_cTmsXGPqOtK0q8UW5164QTltbJRJFR_Efxq_BRL1-o,1311
 src/cli/utils/cicd.py,sha256=VSkJTL7OBnXQ6Zbb2gzgw5gLWpwUjfr9XthqTpJ2Oj8,26197
 src/cli/utils/datastores.py,sha256=gv1V6eDcOEKx4MRNG5C3Y-VfixYq1AzQuaYMLp8QRNo,1058
 src/cli/utils/gcp.py,sha256=cnuCyN144eiyYc9aJNEK9JnyWN66rdevugoMdDYC1UU,4032
 src/cli/utils/logging.py,sha256=0lHe4EPi1A8sOx9xkA7gS4UNl0GsIyp2ahydkkuCzLY,1570
-src/cli/utils/template.py,sha256=VYg59SwfgYmvcq09mD7xz-wTj2LodPBH2bjlEesu8ag,30482
+src/cli/utils/remote_template.py,sha256=LA2gAo1i_PCMMB6gqWPOH-WWR8MFyr9CrK9_-f1jVIY,7895
+src/cli/utils/template.py,sha256=GpUWMQ7hfO5nkACRQ3_aFbn5yT2MjO58nr9Hs0Fp8kM,33700
 src/cli/utils/version.py,sha256=F4udQmzniPStqWZFIgnv3Qg3l9non4mfy2An-Oveqmc,2916
 src/data_ingestion/README.md,sha256=LNxSQoJW9JozK-TbyGQLj5L_MGWNwrfLk6V6RmQ2oBQ,4032
 src/data_ingestion/pyproject.toml,sha256=-1Mf2QB8K70ICQV5UPZDpf-fN3UwEQLVzQyxfakCSTY,445
@@ -182,25 +184,25 @@ src/resources/docs/adk-cheatsheet.md,sha256=KTCdM7hOvsv1-GgwEBMMU6kLk3WHQ69RAs6V
 src/resources/idx/idx-template.json,sha256=07OQZCPp45Iqor2O7Tm1e1Gmsdd-AmmUofSvA7y-oRs,793
 src/resources/idx/idx-template.nix,sha256=sesHGev_PYtVDg0J5tHkg0OO7IR1Bz2iAtl_if3Ar3M,892
 src/resources/idx/.idx/dev.nix,sha256=XQ4T1xt5I-8SVwnI37v56RFFlxa58Ko-a9G2-oelYAI,1602
-src/resources/locks/uv-adk_base-agent_engine.lock,sha256=At7JUJjTZ7fqapE-yTv6KOnZnmEUFfggc6fR670088M,477091
-src/resources/locks/uv-adk_base-cloud_run.lock,sha256=y9E2KvWDophBoEb3VOlD08g45Xzz91iOfW4kUotKJFM,630449
-src/resources/locks/uv-adk_gemini_fullstack-agent_engine.lock,sha256=At7JUJjTZ7fqapE-yTv6KOnZnmEUFfggc6fR670088M,477091
-src/resources/locks/uv-adk_gemini_fullstack-cloud_run.lock,sha256=y9E2KvWDophBoEb3VOlD08g45Xzz91iOfW4kUotKJFM,630449
-src/resources/locks/uv-agentic_rag-agent_engine.lock,sha256=BuOCpKLD7hZMAAcoUEn52-q5ZjgfRXjtkgGwa9oFrcw,535028
-src/resources/locks/uv-agentic_rag-cloud_run.lock,sha256=cgWp0MrqkagHZlJpzrl_BR2qXy6LH6R5zat88wY_QqY,708082
-src/resources/locks/uv-crewai_coding_crew-agent_engine.lock,sha256=sjCgdsjhHLT_BymEjHF4e12ptEilMqEgOzK2WifutnQ,813067
-src/resources/locks/uv-crewai_coding_crew-cloud_run.lock,sha256=I7UZ6TRKwBQhQu9gZ7PiNZf0fiu0XeFT6LQ000X2hdw,1060937
-src/resources/locks/uv-langgraph_base_react-agent_engine.lock,sha256=2LK-b_sXcECpCOyB8c8Hg_Tn-oWoPywTjoXtPIkofAo,681742
-src/resources/locks/uv-langgraph_base_react-cloud_run.lock,sha256=890djdH1xysQjvyNYsR2e-gBMqIvY1sSd1nGrIdrwKs,899376
-src/resources/locks/uv-live_api-cloud_run.lock,sha256=pzzQFnkozda6LCKiWgaw933YaQT0nlV8R2RLLnQ4aAI,822935
+src/resources/locks/uv-adk_base-agent_engine.lock,sha256=hK9YQfIRT6kfSlFUBrhUEXeXZ3IS2muNV8T3lkihQAY,483186
+src/resources/locks/uv-adk_base-cloud_run.lock,sha256=6t7zeqDFtMyPFrIiF6Xo1p4POyyYEnc6pyUtkHzf2EA,637362
+src/resources/locks/uv-adk_gemini_fullstack-agent_engine.lock,sha256=hK9YQfIRT6kfSlFUBrhUEXeXZ3IS2muNV8T3lkihQAY,483186
+src/resources/locks/uv-adk_gemini_fullstack-cloud_run.lock,sha256=6t7zeqDFtMyPFrIiF6Xo1p4POyyYEnc6pyUtkHzf2EA,637362
+src/resources/locks/uv-agentic_rag-agent_engine.lock,sha256=1eA8gC_Y42ooUbJ4JxAG5n2cbHHKUBZe6D4FItc_Mvg,541123
+src/resources/locks/uv-agentic_rag-cloud_run.lock,sha256=j8vpv7fa0ndEPYKzG71vkwZmHQ8f5AdtTqb2WwlgzXc,714995
+src/resources/locks/uv-crewai_coding_crew-agent_engine.lock,sha256=EagJM13n7X8vqcE3HO7rF-Z2jMEobFlWPZjOqEEW_Fo,813064
+src/resources/locks/uv-crewai_coding_crew-cloud_run.lock,sha256=WzCE7940FbtzjVnpy5vPe4Mp7JA9nQvE2ROuWmhEHzc,1060934
+src/resources/locks/uv-langgraph_base_react-agent_engine.lock,sha256=b9wpOgH6uqdFTDfCxxfN1dVCH1ZFb_SJhhZh51fkxBE,681721
+src/resources/locks/uv-langgraph_base_react-cloud_run.lock,sha256=zmX9dyHsaOt62LoItbhn1h7BiyGqdk-07Mbf8GEvxU0,899355
+src/resources/locks/uv-live_api-cloud_run.lock,sha256=JsTYkungSDMWm756YxXmHXJ2LNO9dhS8DEBTJTuIquk,822914
 src/resources/setup_cicd/cicd_variables.tf,sha256=PMflYe1TzQi63LORHkmeCktTYzXFplJgxffNH4DtuAQ,1244
 src/resources/setup_cicd/github.tf,sha256=V2XZ7bKdJ9fzibsjIrI-loHQ1eQbfjNWVPLDPIAUeTA,2807
 src/resources/setup_cicd/providers.tf,sha256=Km4z6IJt7x7PLaa0kyZbBrO2m3lpuIJZFD5jB7QBfF0,1122
 src/utils/generate_locks.py,sha256=6V1B8V2BEuevWnXUsxZVTrLjXwFRII8UfsIGrQqZxVs,4320
-src/utils/lock_utils.py,sha256=RSE6n3hBkH64xNm3Q5wrR0Pqbeo-oc7xaTOhA9yzHjk,2275
+src/utils/lock_utils.py,sha256=IFOMUWtb-ypm2Y8w8J5y2oI_-MaPuwPF_JOAAlnNudA,2275
 src/utils/watch_and_rebuild.py,sha256=vP4yIiA7E_lj5sfQdJUl8TXas6V7msDg8XWUutAC05Q,6679
-agent_starter_pack-0.8.0.dist-info/METADATA,sha256=nCOvlOlpJzDrhmFh5PCLWyEAso0H8t0s3NkR-l4uSeM,11146
-agent_starter_pack-0.8.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-agent_starter_pack-0.8.0.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
-agent_starter_pack-0.8.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-agent_starter_pack-0.8.0.dist-info/RECORD,,
+agent_starter_pack-0.9.0.dist-info/METADATA,sha256=tm8hhXSmxExEPbCj30Q1GlG9U0W5xiLP84JTavvezJI,11286
+agent_starter_pack-0.9.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+agent_starter_pack-0.9.0.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
+agent_starter_pack-0.9.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+agent_starter_pack-0.9.0.dist-info/RECORD,,

agents/adk_base/{template/.templateconfig.yaml → .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.5.0"]
+  extra_dependencies: ["google-adk~=1.6.0"]
   tags: ["adk"]
   frontend_type: "None"
     

agents/adk_gemini_fullstack/{template/.templateconfig.yaml → .template/templateconfig.yaml}

@@ -18,12 +18,12 @@ settings:
   requires_data_ingestion: false
   requires_session: true
   deployment_targets: ["agent_engine", "cloud_run"]
-  extra_dependencies: ["google-adk~=1.5.0"]
+  extra_dependencies: ["google-adk~=1.6.0"]
   tags: ["adk"]
   frontend_type: "adk_gemini_fullstack"
   commands:
     override:
-      install: "npm --prefix frontend install"
+      install: "uv sync --dev --extra jupyter && npm --prefix frontend install"
     extra:
       dev: 
         command: 'make dev-backend & make dev-frontend'

agents/agentic_rag/{template/.templateconfig.yaml → .template/templateconfig.yaml}

@@ -19,7 +19,7 @@ settings:
   requires_session: true
   deployment_targets: ["agent_engine", "cloud_run"]
   extra_dependencies: [
-    "google-adk~=1.5.0",
+    "google-adk~=1.6.0",
     "langchain-google-vertexai~=2.0.7",
     "langchain~=0.3.24",
     "langchain-core~=0.3.55",

src/base_template/Makefile

@@ -1,8 +1,12 @@
 # Install dependencies using uv package manager
 install:
 	@command -v uv >/dev/null 2>&1 || { echo "uv is not installed. Installing uv..."; curl -LsSf https://astral.sh/uv/0.6.12/install.sh | sh; source $HOME/.local/bin/env; }
+{%- if cookiecutter.settings.get("commands", {}).get("override", {}).get("install") %} 
+	{{cookiecutter.settings.get("commands", {}).get("override", {}).get("install")}}
+{%- else %}
 	uv sync --dev{% if cookiecutter.agent_name != 'live_api' and "adk" not in cookiecutter.tags %} --extra streamlit{%- endif %} --extra jupyter{% if cookiecutter.agent_name == 'live_api' %} && npm --prefix frontend install{%- endif %}
-{%- if cookiecutter.settings.get("commands", {}).get("override", {}).get("install") %} && {{cookiecutter.settings.get("commands", {}).get("override", {}).get("install")}}{%- endif %}
+{%- endif %}
+
 {%- if cookiecutter.settings.get("commands", {}).get("extra", {}) %}
 {%- for cmd_name, cmd_value in cookiecutter.settings.get("commands", {}).get("extra", {}).items() %}
 

src/base_template/pyproject.toml

@@ -16,12 +16,12 @@ dependencies = [
 {%- endif %}
     "google-cloud-logging~=3.11.4",
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
-    "google-cloud-aiplatform[evaluation]~=1.101.0",
+    "google-cloud-aiplatform[evaluation]~=1.103.0",
     "fastapi~=0.115.8",
     "uvicorn~=0.34.0",
     "psycopg2-binary>=2.9.10",
 {%- elif cookiecutter.deployment_target == 'agent_engine' %}
-    "google-cloud-aiplatform[evaluation,agent-engines]~=1.101.0"
+    "google-cloud-aiplatform[evaluation,agent-engines]~=1.103.0"
 {%- endif %}
 ]
 {% if cookiecutter.deployment_target == 'cloud_run' %}

src/cli/commands/create.py

@@ -25,6 +25,13 @@ from rich.prompt import IntPrompt, Prompt
 from ..utils.datastores import DATASTORE_TYPES
 from ..utils.gcp import verify_credentials, verify_vertex_connection
 from ..utils.logging import handle_cli_error
+from ..utils.remote_template import (
+    fetch_remote_template,
+    get_base_template_name,
+    load_remote_template_config,
+    merge_template_configs,
+    parse_agent_spec,
+)
 from ..utils.template import (
     get_available_agents,
     get_template_path,
@@ -75,7 +82,11 @@ def normalize_project_name(project_name: str) -> str:
 @click.command()
 @click.pass_context
 @click.argument("project_name")
-@click.option("--agent", "-a", help="agent name or number to use")
+@click.option(
+    "--agent",
+    "-a",
+    help="Template identifier to use. Can be a local agent name (e.g., `chat_agent`), a local path (`local@/path/to/template`), an `adk-samples` shortcut (e.g., `adk@data-science`), or a remote Git URL. Both shorthand (e.g., `github.com/org/repo/path@main`) and full URLs from your browser (e.g., `https://github.com/org/repo/tree/main/path`) are supported. Lists available local templates if omitted.",
+)
 @click.option(
     "--deployment-target",
     "-d",
@@ -138,11 +149,26 @@ def create(
     """Create GCP-based AI agent projects from templates."""
     try:
         # Display welcome banner
-        console.print("\n=== GCP Agent Starter Pack :rocket:===", style="bold blue")
-        console.print("Welcome to the Agent Starter Pack!")
-        console.print(
-            "This tool will help you create an end-to-end production-ready AI agent in Google Cloud!\n"
-        )
+        if agent and agent.startswith("adk@"):
+            console.print(
+                "\n=== Welcome to [link=https://github.com/google/adk-samples]google/adk-samples[/link]! ✨ ===",
+                style="bold blue",
+            )
+            console.print(
+                "Powered by ([link=https://goo.gle/agent-starter-pack]Google's Agent Starter Pack [/link])\n",
+            )
+            console.print(
+                "This tool will help you create an end-to-end production-ready AI agent in Google Cloud!\n"
+            )
+        else:
+            console.print(
+                "\n=== Google Cloud Agent Starter Pack :rocket:===",
+                style="bold blue",
+            )
+            console.print("Welcome to the Agent Starter Pack!")
+            console.print(
+                "This tool will help you create an end-to-end production-ready AI agent in Google Cloud!\n"
+            )
         # Validate project name
         if len(project_name) > 26:
             console.print(
@@ -172,23 +198,51 @@ def create(
             )
             return
 
-        # Agent selection
+        # Agent selection - handle remote templates
         selected_agent = None
+        template_source_path = None
+
         if agent:
-            agents = get_available_agents()
-            # First check if it's a valid agent name
-            if any(p["name"] == agent for p in agents.values()):
-                selected_agent = agent
+            if agent.startswith("local@"):
+                path_str = agent.split("@", 1)[1]
+                template_source_path = pathlib.Path(path_str).resolve()
+                if not template_source_path.is_dir():
+                    raise click.ClickException(
+                        f"Local path not found or not a directory: {template_source_path}"
+                    )
+                selected_agent = f"local_{template_source_path.name}"
+                console.print(f"Using local template: {template_source_path}")
             else:
-                # Try numeric agent selection if input is a number
-                try:
-                    agent_num = int(agent)
-                    if agent_num in agents:
-                        selected_agent = agents[agent_num]["name"]
+                # Check if it's a remote template specification
+                remote_spec = parse_agent_spec(agent)
+                if remote_spec:
+                    if remote_spec.is_adk_samples:
+                        console.print(
+                            f"> Fetching template: {remote_spec.template_path}",
+                            style="bold blue",
+                        )
                     else:
-                        raise ValueError(f"Invalid agent number: {agent_num}")
-                except ValueError as err:
-                    raise ValueError(f"Invalid agent name or number: {agent}") from err
+                        console.print(f"Fetching remote template: {agent}")
+                    template_source_path = fetch_remote_template(remote_spec)
+                    selected_agent = f"remote_{hash(agent)}"  # Generate unique name for remote template
+                else:
+                    # Handle local agent selection
+                    agents = get_available_agents()
+                    # First check if it's a valid agent name
+                    if any(p["name"] == agent for p in agents.values()):
+                        selected_agent = agent
+                    else:
+                        # Try numeric agent selection if input is a number
+                        try:
+                            agent_num = int(agent)
+                            if agent_num in agents:
+                                selected_agent = agents[agent_num]["name"]
+                            else:
+                                raise ValueError(f"Invalid agent number: {agent_num}")
+                        except ValueError as err:
+                            raise ValueError(
+                                f"Invalid agent name or number: {agent}"
+                            ) from err
 
         final_agent = (
             selected_agent
@@ -198,13 +252,54 @@ def create(
         if debug:
             logging.debug(f"Selected agent: {agent}")
 
-        template_path = (
-            pathlib.Path(__file__).parent.parent.parent.parent
-            / "agents"
-            / final_agent
-            / "template"
-        )
-        config = load_template_config(template_path)
+        # Load template configuration based on whether it's remote or local
+        if template_source_path:
+            # Load remote template config
+            source_config = load_remote_template_config(template_source_path)
+
+            # Check if remote template has the required structure
+            template_config_path = (
+                template_source_path / ".template" / "templateconfig.yaml"
+            )
+
+            if not template_config_path.exists():
+                console.print(
+                    "Error: Template is invalid or improperly structured.",
+                    style="bold red",
+                )
+                console.print(
+                    "Templates must contain a '.template/templateconfig.yaml' file.\n\n"
+                    "Expected structure:\n"
+                    "  your-template/\n"
+                    "  └── .template/\n"
+                    "      ├── templateconfig.yaml\n"
+                    "      └── [other template files...]",
+                    style="yellow",
+                )
+                return
+
+            # Load base template config for inheritance
+            base_template_name = get_base_template_name(source_config)
+            base_template_path = (
+                pathlib.Path(__file__).parent.parent.parent.parent
+                / "agents"
+                / base_template_name
+                / ".template"
+            )
+            base_config = load_template_config(base_template_path)
+
+            # Merge configs: remote inherits from and overrides base
+            config = merge_template_configs(base_config, source_config)
+            # For remote templates, use the template/ subdirectory as the template source
+            template_path = template_source_path / ".template"
+        else:
+            template_path = (
+                pathlib.Path(__file__).parent.parent.parent.parent
+                / "agents"
+                / final_agent
+                / ".template"
+            )
+            config = load_template_config(template_path)
         # Data ingestion and datastore selection
         if include_data_ingestion or datastore:
             # If datastore is specified but include_data_ingestion is not, set it to True
@@ -231,10 +326,20 @@ def create(
                     logging.debug(f"Selected datastore type: {datastore}")
 
         # Deployment target selection
+        # For remote templates, we need to use the base template name for deployment target selection
+        deployment_agent_name = final_agent
+        remote_config = None
+        if template_source_path:
+            # Use the base template name from remote config for deployment target selection
+            deployment_agent_name = get_base_template_name(config)
+            remote_config = config
+
         final_deployment = (
             deployment_target
             if deployment_target
-            else prompt_deployment_target(final_agent)
+            else prompt_deployment_target(
+                deployment_agent_name, remote_config=remote_config
+            )
         )
         if debug:
             logging.debug(f"Selected deployment target: {final_deployment}")
@@ -254,7 +359,7 @@ def create(
                 )
                 return
 
-            if final_deployment == "cloud_run" and not session_type:
+            if final_deployment in ("cloud_run") and not session_type:
                 final_session_type = prompt_session_type_selection()
         else:
             # Agents that don't require session management always use in-memory sessions
@@ -307,7 +412,10 @@ def create(
                 )
 
         # Process template
-        template_path = get_template_path(final_agent, debug=debug)
+        if not template_source_path:
+            template_path = get_template_path(final_agent, debug=debug)
+        # template_path is already set above for remote templates
+
         if debug:
             logging.debug(f"Template path: {template_path}")
             logging.debug(f"Processing template for project: {project_name}")
@@ -319,20 +427,24 @@ def create(
         if debug:
             logging.debug(f"Output directory: {destination_dir}")
 
-        process_template(
-            final_agent,
-            template_path,
-            project_name,
-            deployment_target=final_deployment,
-            include_data_ingestion=include_data_ingestion,
-            datastore=datastore,
-            session_type=final_session_type,
-            output_dir=destination_dir,
-        )
-
-        # Replace region in all files if a different region was specified
-        if region != "us-central1":
-            replace_region_in_files(project_path, region, debug=debug)
+        try:
+            # Process template (handles both local and remote templates)
+            process_template(
+                final_agent,
+                template_path,
+                project_name,
+                deployment_target=final_deployment,
+                include_data_ingestion=include_data_ingestion,
+                datastore=datastore,
+                session_type=final_session_type,
+                output_dir=destination_dir,
+                remote_template_path=template_source_path,
+                remote_config=config if template_source_path else None,
+            )
+        finally:
+            # Replace region in all files if a different region was specified
+            if region != "us-central1":
+                replace_region_in_files(project_path, region, debug=debug)
 
         project_path = destination_dir / project_name
         cd_path = project_path if output_dir else project_name

src/cli/commands/list.py

@@ -0,0 +1,158 @@
+# 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 logging
+import pathlib
+
+import click
+import yaml
+from rich.console import Console
+from rich.table import Table
+
+from ..utils.remote_template import fetch_remote_template, parse_agent_spec
+from ..utils.template import get_available_agents
+
+console = Console()
+
+
+def display_agents_from_path(base_path: pathlib.Path, source_name: str) -> None:
+    """Scans a directory and displays available agents."""
+    table = Table(
+        title=f"Available agents in [bold blue]{source_name}[/]",
+        show_header=True,
+        header_style="bold magenta",
+    )
+    table.add_column("Name", style="bold")
+    table.add_column("Path", style="cyan")
+    table.add_column("Description", style="dim")
+
+    if not base_path.is_dir():
+        console.print(f"Directory not found: {base_path}", style="bold red")
+        return
+
+    found_agents = False
+    # Search for templateconfig.yaml files to identify agents
+    for config_path in sorted(base_path.glob("**/templateconfig.yaml")):
+        try:
+            with open(config_path) as f:
+                config = yaml.safe_load(f)
+
+            agent_name = config.get("name", config_path.parent.parent.name)
+            description = config.get("description", "No description.")
+
+            # Display the agent's path relative to the scanned directory
+            relative_path = config_path.parent.parent.relative_to(base_path)
+
+            table.add_row(agent_name, f"/{relative_path}", description)
+            found_agents = True
+
+        except Exception as e:
+            logging.warning(
+                f"Could not load agent from {config_path.parent.parent}: {e}"
+            )
+
+    if not found_agents:
+        console.print(f"No agents found in {source_name}", style="yellow")
+    else:
+        console.print(table)
+
+
+def list_remote_agents(remote_source: str, scan_from_root: bool = False) -> None:
+    """Lists agents from a remote source (Git URL)."""
+    spec = parse_agent_spec(remote_source)
+    if not spec:
+        console.print(f"Invalid remote source: {remote_source}", style="bold red")
+        return
+
+    console.print(f"\nFetching agents from [bold blue]{remote_source}[/]...")
+
+    try:
+        # fetch_remote_template clones the repo and returns a path to the
+        # specific template directory within the repo.
+        template_dir_path = fetch_remote_template(spec)
+
+        if scan_from_root:
+            # For ADK, we want to scan the entire repo. We need to find the
+            # root of the repo and scan from there.
+            scan_path = template_dir_path
+            while not (scan_path / ".git").exists() and scan_path.parent != scan_path:
+                scan_path = scan_path.parent
+        else:
+            # For other git repos, respect the path given in the URL.
+            scan_path = template_dir_path
+
+        display_agents_from_path(scan_path, remote_source)
+
+    except (RuntimeError, FileNotFoundError) as e:
+        console.print(f"Error: {e}", style="bold red")
+
+
+@click.command("list")
+@click.option(
+    "--adk",
+    is_flag=True,
+    help="List agents from the official google/adk-samples repository.",
+)
+@click.option(
+    "--source",
+    "-s",
+    help="List agents from a local path or a remote Git URL.",
+)
+def list_agents(adk: bool, source: str | None) -> None:
+    """
+    Lists available agent templates.
+
+    Defaults to listing built-in agents if no options are provided.
+    """
+    if adk and source:
+        console.print(
+            "Error: --adk and --source are mutually exclusive.", style="bold red"
+        )
+        return
+
+    if adk:
+        list_remote_agents("https://github.com/google/adk-samples", scan_from_root=True)
+        return
+
+    if source:
+        source_path = pathlib.Path(source)
+        if source_path.is_dir():
+            display_agents_from_path(source_path, f"local directory '{source}'")
+        elif parse_agent_spec(source):
+            list_remote_agents(source)
+        else:
+            console.print(
+                f"Error: Source '{source}' is not a valid local directory or remote URL.",
+                style="bold red",
+            )
+        return
+
+    # Default behavior: list built-in agents
+    agents = get_available_agents()
+    if not agents:
+        console.print("No built-in agents found.", style="yellow")
+        return
+
+    table = Table(
+        title="Available built-in agents",
+        show_header=True,
+        header_style="bold magenta",
+    )
+    table.add_column("Number", style="dim", width=12)
+    table.add_column("Name", style="bold")
+    table.add_column("Description")
+
+    for i, (_, agent) in enumerate(agents.items()):
+        table.add_row(str(i + 1), agent["name"], agent["description"])
+    console.print(table)