agent-starter-pack 0.4.5__tar.gz → 0.5.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (235) hide show
  1. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/PKG-INFO +2 -2
  2. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/README.md +1 -1
  3. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/template/.templateconfig.yaml +1 -1
  4. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/tests/integration/test_agent.py +1 -1
  5. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/template/.templateconfig.yaml +1 -1
  6. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/tests/integration/test_agent.py +1 -1
  7. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/app/server.py +5 -1
  8. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/cli/setup_cicd.md +8 -5
  9. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/deployment.md +1 -1
  10. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/development-guide.md +2 -2
  11. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/getting-started.md +7 -8
  12. agent_starter_pack-0.5.1/docs/guide/installation.md +151 -0
  13. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/pyproject.toml +1 -1
  14. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/README.md +2 -2
  15. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/README.md +1 -1
  16. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/pyproject.toml +2 -2
  17. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/commands/create.py +11 -3
  18. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/tests/load_test/README.md +2 -2
  19. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/app/server.py +1 -1
  20. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/tests/load_test/README.md +2 -2
  21. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/stream_handler.py +13 -4
  22. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/idx/.idx/dev.nix +2 -9
  23. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-adk_base-agent_engine.lock +340 -334
  24. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-adk_base-cloud_run.lock +412 -405
  25. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-agentic_rag-agent_engine.lock +531 -522
  26. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-agentic_rag-cloud_run.lock +683 -665
  27. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-crewai_coding_crew-agent_engine.lock +678 -629
  28. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-crewai_coding_crew-cloud_run.lock +833 -773
  29. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-langgraph_base_react-agent_engine.lock +647 -571
  30. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-langgraph_base_react-cloud_run.lock +826 -730
  31. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-live_api-cloud_run.lock +160 -159
  32. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_utils/test_stream_handler.py +77 -18
  33. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/uv.lock +2580 -2580
  34. agent_starter_pack-0.4.5/docs/guide/installation.md +0 -74
  35. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/cd/test_e2e.yaml +0 -0
  36. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/ci/build_use_wheel.yaml +0 -0
  37. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/ci/lint.yaml +0 -0
  38. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/ci/lint_templated_agents.yaml +0 -0
  39. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/ci/test.yaml +0 -0
  40. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/ci/test_templated_agents.yaml +0 -0
  41. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/terraform/apis.tf +0 -0
  42. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/terraform/build_triggers.tf +0 -0
  43. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/terraform/service_account.tf +0 -0
  44. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/terraform/storage.tf +0 -0
  45. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/terraform/variables.tf +0 -0
  46. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.github/workflows/docs.yml +0 -0
  47. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.gitignore +0 -0
  48. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/CODE_OF_CONDUCT.md +0 -0
  49. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/CONTRIBUTING.md +0 -0
  50. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/LICENSE +0 -0
  51. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/Makefile +0 -0
  52. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/README.md +0 -0
  53. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/app/agent.py +0 -0
  54. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/notebooks/adk_app_testing.ipynb +0 -0
  55. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/notebooks/evaluating_adk_agent.ipynb +0 -0
  56. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/README.md +0 -0
  57. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/app/agent.py +0 -0
  58. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/app/retrievers.py +0 -0
  59. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/app/templates.py +0 -0
  60. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/notebooks/adk_app_testing.ipynb +0 -0
  61. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/notebooks/evaluating_adk_agent.ipynb +0 -0
  62. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/README.md +0 -0
  63. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/app/agent.py +0 -0
  64. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/app/crew/config/agents.yaml +0 -0
  65. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/app/crew/config/tasks.yaml +0 -0
  66. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/app/crew/crew.py +0 -0
  67. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/notebooks/evaluating_crewai_agent.ipynb +0 -0
  68. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/notebooks/evaluating_langgraph_agent.ipynb +0 -0
  69. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/template/.templateconfig.yaml +0 -0
  70. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/tests/integration/test_agent.py +0 -0
  71. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/langgraph_base_react/README.md +0 -0
  72. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/langgraph_base_react/app/agent.py +0 -0
  73. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/langgraph_base_react/notebooks/evaluating_langgraph_agent.ipynb +0 -0
  74. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/langgraph_base_react/template/.templateconfig.yaml +0 -0
  75. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/langgraph_base_react/tests/integration/test_agent.py +0 -0
  76. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/README.md +0 -0
  77. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/app/agent.py +0 -0
  78. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/template/.templateconfig.yaml +0 -0
  79. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/tests/integration/test_server_e2e.py +0 -0
  80. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/tests/load_test/load_test.py +0 -0
  81. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/tests/unit/test_server.py +0 -0
  82. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/.vitepress/config.js +0 -0
  83. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/agents/overview.md +0 -0
  84. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/cli/create.md +0 -0
  85. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/cli/index.md +0 -0
  86. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/data-ingestion.md +0 -0
  87. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/observability.md +0 -0
  88. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/troubleshooting.md +0 -0
  89. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/video-tutorials.md +0 -0
  90. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/why_starter_pack.md +0 -0
  91. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/adk_logo.png +0 -0
  92. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/agent_starter_pack_screenshot.png +0 -0
  93. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/ags_high_level_architecture.png +0 -0
  94. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/icon.png +0 -0
  95. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/logo.png +0 -0
  96. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/prototype_to_prod.png +0 -0
  97. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/why_sp_edited.png +0 -0
  98. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/why_starter_pack.png +0 -0
  99. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/index.md +0 -0
  100. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/package-lock.json +0 -0
  101. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/package.json +0 -0
  102. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/.gitignore +0 -0
  103. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/Makefile +0 -0
  104. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/app/__init__.py +0 -0
  105. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/app/utils/tracing.py +0 -0
  106. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/app/utils/typing.py +0 -0
  107. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/cd/deploy-to-prod.yaml +0 -0
  108. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/cd/staging.yaml +0 -0
  109. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/ci/pr_checks.yaml +0 -0
  110. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/apis.tf +0 -0
  111. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/build_triggers.tf +0 -0
  112. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/apis.tf +0 -0
  113. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/iam.tf +0 -0
  114. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/log_sinks.tf +0 -0
  115. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/providers.tf +0 -0
  116. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/storage.tf +0 -0
  117. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/variables.tf +0 -0
  118. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/vars/env.tfvars +0 -0
  119. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/iam.tf +0 -0
  120. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/locals.tf +0 -0
  121. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/log_sinks.tf +0 -0
  122. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/providers.tf +0 -0
  123. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/service_accounts.tf +0 -0
  124. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/storage.tf +0 -0
  125. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/variables.tf +0 -0
  126. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/vars/env.tfvars +0 -0
  127. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/tests/unit/test_dummy.py +0 -0
  128. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/commands/setup_cicd.py +0 -0
  129. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/main.py +0 -0
  130. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/__init__.py +0 -0
  131. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/cicd.py +0 -0
  132. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/datastores.py +0 -0
  133. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/gcp.py +0 -0
  134. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/logging.py +0 -0
  135. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/template.py +0 -0
  136. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/version.py +0 -0
  137. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/README.md +0 -0
  138. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/data_ingestion_pipeline/components/ingest_data.py +0 -0
  139. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/data_ingestion_pipeline/components/process_data.py +0 -0
  140. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/data_ingestion_pipeline/pipeline.py +0 -0
  141. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/data_ingestion_pipeline/submit_pipeline.py +0 -0
  142. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/pyproject.toml +0 -0
  143. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/uv.lock +0 -0
  144. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/app/agent_engine_app.py +0 -0
  145. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/app/utils/gcs.py +0 -0
  146. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/deployment_metadata.json +0 -0
  147. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/notebooks/intro_agent_engine.ipynb +0 -0
  148. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/tests/integration/test_agent_engine_app.py +0 -0
  149. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/tests/load_test/.results/.placeholder +0 -0
  150. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/tests/load_test/load_test.py +0 -0
  151. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/Dockerfile +0 -0
  152. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/tests/integration/test_server_e2e.py +0 -0
  153. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/tests/load_test/.results/.placeholder +0 -0
  154. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/tests/load_test/load_test.py +0 -0
  155. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/uv.lock +0 -0
  156. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/package-lock.json +0 -0
  157. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/package.json +0 -0
  158. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/public/favicon.ico +0 -0
  159. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/public/index.html +0 -0
  160. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/public/robots.txt +0 -0
  161. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/App.scss +0 -0
  162. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/App.test.tsx +0 -0
  163. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/App.tsx +0 -0
  164. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/components/audio-pulse/AudioPulse.tsx +0 -0
  165. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/components/audio-pulse/audio-pulse.scss +0 -0
  166. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/components/control-tray/ControlTray.tsx +0 -0
  167. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/components/control-tray/control-tray.scss +0 -0
  168. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/components/logger/Logger.tsx +0 -0
  169. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/components/logger/logger.scss +0 -0
  170. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/components/logger/mock-logs.ts +0 -0
  171. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/components/side-panel/SidePanel.tsx +0 -0
  172. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/components/side-panel/side-panel.scss +0 -0
  173. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/contexts/LiveAPIContext.tsx +0 -0
  174. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/hooks/use-live-api.ts +0 -0
  175. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/hooks/use-media-stream-mux.ts +0 -0
  176. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/hooks/use-screen-capture.ts +0 -0
  177. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/hooks/use-webcam.ts +0 -0
  178. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/index.css +0 -0
  179. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/index.tsx +0 -0
  180. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/multimodal-live-types.ts +0 -0
  181. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/react-app-env.d.ts +0 -0
  182. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/reportWebVitals.ts +0 -0
  183. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/setupTests.ts +0 -0
  184. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/utils/audio-recorder.ts +0 -0
  185. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/utils/audio-streamer.ts +0 -0
  186. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/utils/audioworklet-registry.ts +0 -0
  187. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/utils/multimodal-live-client.ts +0 -0
  188. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/utils/store-logger.ts +0 -0
  189. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/utils/utils.ts +0 -0
  190. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/utils/worklets/audio-processing.ts +0 -0
  191. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/utils/worklets/vol-meter.ts +0 -0
  192. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/tsconfig.json +0 -0
  193. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/side_bar.py +0 -0
  194. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/streamlit_app.py +0 -0
  195. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/style/app_markdown.py +0 -0
  196. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/chat_utils.py +0 -0
  197. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/local_chat_history.py +0 -0
  198. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/message_editing.py +0 -0
  199. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/multimodal_utils.py +0 -0
  200. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/title_summary.py +0 -0
  201. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/side_bar.py +0 -0
  202. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/streamlit_app.py +0 -0
  203. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/style/app_markdown.py +0 -0
  204. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/chat_utils.py +0 -0
  205. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/local_chat_history.py +0 -0
  206. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/message_editing.py +0 -0
  207. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/multimodal_utils.py +0 -0
  208. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/stream_handler.py +0 -0
  209. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/title_summary.py +0 -0
  210. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/containers/data_processing/Dockerfile +0 -0
  211. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/containers/e2e-tests/Dockerfile +0 -0
  212. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/idx/idx-template.json +0 -0
  213. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/idx/idx-template.nix +0 -0
  214. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/setup_cicd/cicd_variables.tf +0 -0
  215. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/setup_cicd/github.tf +0 -0
  216. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/setup_cicd/providers.tf +0 -0
  217. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/utils/generate_locks.py +0 -0
  218. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/utils/lock_utils.py +0 -0
  219. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/utils/watch_and_rebuild.py +0 -0
  220. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/__init__.py +0 -0
  221. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/cicd/example.env +0 -0
  222. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/cicd/test_e2e_deployment.py +0 -0
  223. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/cli/commands/test_create.py +0 -0
  224. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/cli/commands/test_setup_cicd.py +0 -0
  225. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/cli/utils/test_cicd.py +0 -0
  226. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/integration/test_template_linting.py +0 -0
  227. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/integration/test_templated_patterns.py +0 -0
  228. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_side_bar.py +0 -0
  229. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_streamlit_app.py +0 -0
  230. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_utils/test_chat_utils.py +0 -0
  231. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_utils/test_local_chat_history.py +0 -0
  232. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_utils/test_message_editing.py +0 -0
  233. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_utils/test_multimodal_utils.py +0 -0
  234. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/utils/__init__.py +0 -0
  235. {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/utils/get_agents.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: agent-starter-pack
3
- Version: 0.4.5
3
+ Version: 0.5.1
4
4
  Summary: CLI to bootstrap production-ready Google Cloud GenAI agent projects from templates.
5
5
  Author-email: Google LLC <agent-starter-pack@google.com>
6
6
  License: Apache-2.0
@@ -56,7 +56,7 @@ Ready to build your AI agent? Simply run this command:
56
56
 
57
57
  ```bash
58
58
  # Create and activate a Python virtual environment
59
- python -m venv venv && source venv/bin/activate
59
+ python -m venv .venv && source .venv/bin/activate
60
60
 
61
61
  # Install the agent starter pack
62
62
  pip install agent-starter-pack
@@ -31,7 +31,7 @@ Ready to build your AI agent? Simply run this command:
31
31
 
32
32
  ```bash
33
33
  # Create and activate a Python virtual environment
34
- python -m venv venv && source venv/bin/activate
34
+ python -m venv .venv && source .venv/bin/activate
35
35
 
36
36
  # Install the agent starter pack
37
37
  pip install agent-starter-pack
@@ -17,6 +17,6 @@ example_question: "What's the weather in San Francisco?"
17
17
  settings:
18
18
  requires_data_ingestion: false
19
19
  deployment_targets: ["agent_engine", "cloud_run"]
20
- extra_dependencies: ["google-adk~=0.5.0"]
20
+ extra_dependencies: ["google-adk~=1.1.0"]
21
21
  tags: ["adk"]
22
22
  frontend_type: "None"
@@ -29,7 +29,7 @@ def test_agent_stream() -> None:
29
29
 
30
30
  session_service = InMemorySessionService()
31
31
 
32
- session = session_service.create_session(user_id="test_user", app_name="test")
32
+ session = session_service.create_session_sync(user_id="test_user", app_name="test")
33
33
  runner = Runner(agent=root_agent, session_service=session_service, app_name="test")
34
34
 
35
35
  message = types.Content(
@@ -18,7 +18,7 @@ settings:
18
18
  requires_data_ingestion: true
19
19
  deployment_targets: ["agent_engine", "cloud_run"]
20
20
  extra_dependencies: [
21
- "google-adk~=0.5.0",
21
+ "google-adk~=1.1.0",
22
22
  "langchain-google-vertexai~=2.0.7",
23
23
  "langchain~=0.3.24",
24
24
  "langchain-core~=0.3.55",
@@ -35,7 +35,7 @@ def test_agent_stream(mock_retrieve: MagicMock) -> None:
35
35
 
36
36
  session_service = InMemorySessionService()
37
37
 
38
- session = session_service.create_session(user_id="test_user", app_name="test")
38
+ session = session_service.create_session_sync(user_id="test_user", app_name="test")
39
39
  runner = Runner(agent=root_agent, session_service=session_service, app_name="test")
40
40
 
41
41
  message = types.Content(
@@ -60,6 +60,7 @@ class GeminiSession:
60
60
  self.run_id = "n/a"
61
61
  self.user_id = "n/a"
62
62
  self.tool_functions = tool_functions
63
+ self._tool_tasks: list[asyncio.Task] = []
63
64
 
64
65
  async def receive_from_client(self) -> None:
65
66
  """Listen for and process messages from the client.
@@ -137,7 +138,10 @@ class GeminiSession:
137
138
  message = types.LiveServerMessage.model_validate(raw_message)
138
139
  tool_call = LiveServerToolCall.model_validate(message.tool_call)
139
140
  # Create a separate task to handle the tool call without blocking
140
- asyncio.create_task(self._handle_tool_call(self.session, tool_call))
141
+ task = asyncio.create_task(
142
+ self._handle_tool_call(self.session, tool_call)
143
+ )
144
+ self._tool_tasks.append(task)
141
145
 
142
146
 
143
147
  def get_connect_and_run_callable(websocket: WebSocket) -> Callable:
@@ -4,21 +4,23 @@ The `setup-cicd` command is a powerful utility provided by `agent-starter-pack`
4
4
 
5
5
  **⚡️ Quick Start Example:**
6
6
 
7
- The command is now even simpler to get started with. You can run it without any arguments, and it will prompt you for the required project IDs:
7
+ Getting started is straightforward. We recommend using `uvx` to execute the command, as `uv` (a prerequisite, see below) will handle fetching and running the `agent-starter-pack` for you, even if it's not installed globally:
8
8
 
9
9
  ```bash
10
- agent-starter-pack setup-cicd
10
+ uvx agent-starter-pack setup-cicd
11
11
  ```
12
12
  *(You will be prompted for Staging and Production project IDs)*
13
13
 
14
14
  Alternatively, you can provide the project IDs directly as flags:
15
15
 
16
16
  ```bash
17
- agent-starter-pack setup-cicd \
17
+ uvx agent-starter-pack setup-cicd \
18
18
  --staging-project=your-staging-project-id \
19
19
  --prod-project=your-prod-project-id
20
20
  ```
21
21
 
22
+ **💡 Tip:** Using `uvx` (e.g., `uvx agent-starter-pack ...`) ensures you are able to run the command without needing to install the `agent-starter-pack` package globally or in your current environment. `uv` itself must be installed.
23
+
22
24
  **⚠️ Important Considerations:**
23
25
 
24
26
  * **Experimental:** This command is under active development. Use it with caution and report any issues.
@@ -29,6 +31,7 @@ agent-starter-pack setup-cicd \
29
31
 
30
32
  1. **Run from Project Root:** Execute the command from the root directory of your `agent-starter-pack` project (where `pyproject.toml` is located).
31
33
  2. **Install Tools:**
34
+ * `uv`: The command will be run using `uvx`. Ensure `uv` is installed. (See [uv installation guide](https://github.com/astral-sh/uv#installation))
32
35
  * Terraform
33
36
  * `gh` CLI (GitHub CLI): Install and authenticate using `gh auth login`.
34
37
  * `gcloud` CLI (Google Cloud SDK): Authenticate using `gcloud auth application-default login`.
@@ -51,7 +54,7 @@ The `setup-cicd` command automates the following:
51
54
  ## Running the Command
52
55
 
53
56
  ```bash
54
- agent-starter-pack setup-cicd \
57
+ uvx agent-starter-pack setup-cicd \
55
58
  [--staging-project <YOUR_STAGING_PROJECT_ID>] \
56
59
  [--prod-project <YOUR_PROD_PROJECT_ID>] \
57
60
  [--cicd-project <YOUR_CICD_PROJECT_ID>] \
@@ -76,7 +79,7 @@ agent-starter-pack setup-cicd \
76
79
  * `--auto-approve`: (Optional) Skip interactive prompts (including project ID prompts if flags are omitted). Use carefully.
77
80
  * `--debug`: (Optional) Enable verbose logging.
78
81
 
79
- *(For advanced/programmatic use with pre-existing connections, see options like `--github-pat`, `--github-app-installation-id`, `--host-connection-name` by running `agent-starter-pack setup-cicd --help`)*
82
+ *(For advanced/programmatic use with pre-existing connections, see options like `--github-pat`, `--github-app-installation-id`, `--host-connection-name` by running `uvx agent-starter-pack setup-cicd --help`)*
80
83
 
81
84
  ## After Running the Command
82
85
 
@@ -1,7 +1,7 @@
1
1
  # Deployment
2
2
 
3
3
  ::: tip ⭐ Streamlined Deployment
4
- For a streamlined one-command deployment of the entire CI/CD pipeline and infrastructure using Terraform, you can use the [`agent-starter-pack setup-cicd` CLI command](../cli/setup_cicd). Currently only supporting Github.
4
+ For a streamlined one-command deployment of the entire CI/CD pipeline and infrastructure using Terraform, you can use the [`uvx agent-starter-pack setup-cicd` CLI command](../cli/setup_cicd). Currently only supporting Github.
5
5
  :::
6
6
 
7
7
  The templated agent leverages [**Terraform**](http://terraform.io) to define and provision the underlying infrastructure, while [**Cloud Build**](https://cloud.google.com/build/) orchestrates the continuous integration and continuous deployment (CI/CD) pipeline.
@@ -54,12 +54,12 @@ For reliable, automated deployments to staging and production, a CI/CD pipeline
54
54
  **Option 1: One-Command CI/CD Setup (Recommended for GitHub)**
55
55
  The `agent-starter-pack` CLI streamlines CI/CD setup with GitHub:
56
56
  ```bash
57
- agent-starter-pack setup-cicd
57
+ uvx agent-starter-pack setup-cicd
58
58
  ```
59
59
  This automates creating a GitHub repository, connecting to Cloud Build, setting up staging/production infrastructure with Terraform, and configuring CI/CD triggers.
60
60
 
61
61
  Follow the interactive prompts. For critical systems needing granular control, consider the manual setup.
62
- See the [`agent-starter-pack setup-cicd` CLI reference](https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/cli/setup_cicd.md) for details. *(Note: Automated setup currently supports GitHub only).*
62
+ See the [`agent-starter-pack setup-cicd` CLI reference](../cli/setup_cicd) for details. *(Note: Automated setup currently supports GitHub only).*
63
63
 
64
64
  **Option 2: Manual CI/CD Setup**
65
65
  For full control and compatibility with other Git providers, refer to the [manual deployment setup guide](./deployment.md).
@@ -13,12 +13,13 @@ This guide quickly walks you through setting up your first agent project.
13
13
 
14
14
  ```bash
15
15
  # Create and activate a Python virtual environment (Recommended)
16
- python -m venv venv
17
- source venv/bin/activate # On Windows: venv\Scripts\activate
16
+ python -m venv .venv
17
+ source .venv/bin/activate # On Windows: .venv\Scripts\activate
18
18
 
19
19
  # Install the package
20
20
  pip install agent-starter-pack
21
21
  ```
22
+ Check the [Installation Guide](/guide/installation) for alternative installation methods.
22
23
 
23
24
  ### 2. Create Your Agent Project
24
25
 
@@ -62,10 +63,8 @@ Inside your new project directory (`my-awesome-agent`), you'll find:
62
63
 
63
64
  ### Next Steps
64
65
 
65
- You're ready to go!
66
+ You're ready to go! See the [Development Guide](/guide/development-guide) for detailed instructions on extending, customizing and deploying your agent.
66
67
 
67
- * **Customize:** Modify the code in `app/` to edit prompts, configure tools, adjust API endpoints, customize business logic, extend functionality!
68
- * **Deploy in minutes:** Use the [setup-cicd](/cli/setup_cicd) command.
69
- * **Customized the deployment:** Use Terraform in `deployment/` to deploy to Google Cloud or follow the deployment guide ([Deployment Guide](/guide/deployment)).
70
- * **Add Data (RAG):** Configure [Data Ingestion](/guide/data-ingestion).
71
- * **Monitor:** Explore [Observability](/guide/observability) features.
68
+ - **Add Data (RAG):** Configure [Data Ingestion](/guide/data-ingestion) for knowledge-based agents.
69
+ - **Monitor Performance:** Explore [Observability](/guide/observability) features for production monitoring.
70
+ - **Deploy to Production:** Follow the [Deployment Guide](/guide/deployment) to deploy your agent to Google Cloud.
@@ -0,0 +1,151 @@
1
+ # Installation
2
+
3
+ There are several ways to install the Agent Starter Pack. Choose the method that works best for your workflow.
4
+
5
+ **Want zero setup?** 👉 [Try in Firebase Studio](https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx) or in [Cloud Shell](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)
6
+
7
+ ## `uvx` for Quick Project Creation
8
+
9
+ If you have [uv](https://astral.sh/uv) installed, you can create projects without a permanent installation:
10
+ ```bash
11
+ uvx agent-starter-pack create my-awesome-agent
12
+ ```
13
+
14
+ ## Virtual Environment Installation
15
+
16
+ Installs into an isolated Python environment.
17
+
18
+ ```bash
19
+ # Create and activate venv
20
+ python -m venv .venv && source .venv/bin/activate # source .venv/Scripts/activate for Windows Git Bash
21
+
22
+ # Install using pip or uv
23
+ pip install agent-starter-pack
24
+ ```
25
+
26
+ ## Persistent CLI Installation
27
+
28
+ Installs the `agent-starter-pack` command globally.
29
+
30
+ ### With `pipx` (Isolated Global Tool)
31
+ ```bash
32
+ # Install pipx (if needed)
33
+ python3 -m pip install --user pipx && python3 -m pipx ensurepath
34
+
35
+ # Install Agent Starter Pack
36
+ pipx install agent-starter-pack
37
+ ```
38
+
39
+ ### With `uv tool install` (Fast, Isolated Global Tool)
40
+ Requires `uv` (see `uvx` section for install).
41
+ ```bash
42
+ uv tool install agent-starter-pack
43
+ ```
44
+
45
+ ## Create Project (After Persistent/Venv Install)
46
+
47
+ If you installed via `pipx`, `uv tool install`, or in a virtual environment:
48
+ ```bash
49
+ agent-starter-pack create my-awesome-agent
50
+ ```
51
+
52
+ ## Managing Installation
53
+
54
+ ### Upgrading
55
+ * **`uvx`:** Not needed (always uses latest).
56
+ * **`pipx`:** `pipx upgrade agent-starter-pack`
57
+ * **`uv tool`:** `uv tool install agent-starter-pack` (this upgrades)
58
+ * **`pip`/`uv pip` (in .venv):** `(uv) pip install --upgrade agent-starter-pack`
59
+
60
+ ### Uninstalling
61
+ * **`uvx`:** Not applicable.
62
+ * **`pipx`:** `pipx uninstall agent-starter-pack`
63
+ * **`uv tool`:** `uv tool uninstall agent-starter-pack`
64
+ * **`pip`/`uv pip` (in .venv):** `(uv) pip uninstall agent-starter-pack`
65
+
66
+ ## Troubleshooting Common Installation Issues
67
+
68
+ ### Command Not Found After Installation
69
+
70
+ If you encounter "command not found" errors after installation:
71
+
72
+ 1. **Check your PATH**: Ensure that the Python scripts directory is in your PATH:
73
+ ```bash
74
+ echo $PATH
75
+ ```
76
+ 2. **Verify installation location**: Check where the package was installed:
77
+ ```bash
78
+ pip show agent-starter-pack
79
+ ```
80
+ 3. **Manual path addition**: If needed, add the scripts directory to your PATH:
81
+ ```bash
82
+ export PATH="$HOME/.local/bin:$PATH"
83
+ # For user installations
84
+ ```
85
+ Add this line to your `~/.bashrc` or `~/.zshrc` for persistence.
86
+
87
+ ### Permission Errors During Installation
88
+
89
+ If you encounter permission errors:
90
+
91
+ 1. **Use user installation mode**:
92
+ ```bash
93
+ pip install --user agent-starter-pack
94
+ ```
95
+ 2. **Check directory permissions**:
96
+ ```bash
97
+ ls -la ~/.local/bin
98
+ ```
99
+ 3. **Fix permissions if needed**:
100
+ ```bash
101
+ chmod +x ~/.local/bin/agent-starter-pack
102
+ ```
103
+
104
+ ### Python Version Compatibility Issues
105
+
106
+ If you encounter Python version errors:
107
+
108
+ 1. **Check your Python version**:
109
+ ```bash
110
+ python --version
111
+ ```
112
+ 2. **Install a compatible Python version** if needed (3.10 or newer is required).
113
+ 3. **Create a virtual environment with the correct Python version**:
114
+ ```bash
115
+ python3.10 -m venv .venv
116
+ source .venv/bin/activate
117
+ ```
118
+
119
+ ### Package Dependency Conflicts
120
+
121
+ If you encounter dependency conflicts:
122
+
123
+ 1. **Use a clean virtual environment**:
124
+ ```bash
125
+ python -m venv .venv
126
+ source .venv/bin/activate
127
+ pip install agent-starter-pack
128
+ ```
129
+ 2. **Update pip and setuptools**:
130
+ ```bash
131
+ pip install --upgrade pip setuptools
132
+ ```
133
+ 3. **Install with verbose output to identify conflicts**:
134
+ ```bash
135
+ pip install -v agent-starter-pack
136
+ ```
137
+
138
+ ### Installation Verification
139
+
140
+ To verify your installation is working correctly:
141
+
142
+ 1. **Check the installed version**:
143
+ ```bash
144
+ agent-starter-pack --version
145
+ ```
146
+ 2. **Run the help command**:
147
+ ```bash
148
+ agent-starter-pack --help
149
+ ```
150
+
151
+ If you continue to experience issues, please [file an issue](https://github.com/GoogleCloudPlatform/agent-starter-pack/issues) with details about your environment and the specific error messages you're encountering.
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "agent-starter-pack"
3
- version = "0.4.5"
3
+ version = "0.5.1"
4
4
  description = "CLI to bootstrap production-ready Google Cloud GenAI agent projects from templates."
5
5
  authors = [
6
6
  { name = "Google LLC", email = "agent-starter-pack@google.com" },
@@ -153,13 +153,13 @@ This template follows a "bring your own agent" approach - you focus on your busi
153
153
  1. **Prototype:** Build your Generative AI Agent using the intro notebooks in `notebooks/` for guidance. Use Vertex AI Evaluation to assess performance.
154
154
  2. **Integrate:** Import your agent into the app by editing `app/agent.py`.
155
155
  3. **Test:** Explore your agent functionality using the Streamlit playground with `make playground`. The playground offers features like chat history, user feedback, and various input types, and automatically reloads your agent on code changes.
156
- 4. **Deploy:** Set up and initiate the CI/CD pipelines, customizing tests as necessary. Refer to the [deployment section](#deployment) for comprehensive instructions. For streamlined infrastructure deployment, simply run `agent-starter-pack setup-cicd`. Check out the [`agent-starter-pack setup-cicd` CLI command](https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/cli/setup_cicd.md). Currently only supporting Github.
156
+ 4. **Deploy:** Set up and initiate the CI/CD pipelines, customizing tests as necessary. Refer to the [deployment section](#deployment) for comprehensive instructions. For streamlined infrastructure deployment, simply run `uvx agent-starter-pack setup-cicd`. Check out the [`agent-starter-pack setup-cicd` CLI command](https://googlecloudplatform.github.io/agent-starter-pack/cli/setup_cicd.html). Currently only supporting Github.
157
157
  5. **Monitor:** Track performance and gather insights using Cloud Logging, Tracing, and the Looker Studio dashboard to iterate on your application.
158
158
  {% endif %}
159
159
 
160
160
  ## Deployment
161
161
 
162
- > **Note:** For a streamlined one-command deployment of the entire CI/CD pipeline and infrastructure using Terraform, you can use the [`agent-starter-pack setup-cicd` CLI command](https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/cli/setup_cicd.md). Currently only supporting Github.
162
+ > **Note:** For a streamlined one-command deployment of the entire CI/CD pipeline and infrastructure using Terraform, you can use the [`agent-starter-pack setup-cicd` CLI command](https://googlecloudplatform.github.io/agent-starter-pack/cli/setup_cicd.html). Currently only supporting Github.
163
163
 
164
164
  ### Dev Environment
165
165
 
@@ -29,7 +29,7 @@ The application leverages [**Terraform**](http://terraform.io) to define and pro
29
29
 
30
30
  ## Setup
31
31
 
32
- > **Note:** For a streamlined one-command deployment of the entire CI/CD pipeline and infrastructure using Terraform, you can use the [`agent-starter-pack setup-cicd` CLI command](https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/cli/setup_cicd.md). Currently only supporting Github.
32
+ > **Note:** For a streamlined one-command deployment of the entire CI/CD pipeline and infrastructure using Terraform, you can use the [`uvx agent-starter-pack setup-cicd` CLI command](https://googlecloudplatform.github.io/agent-starter-pack/cli/setup_cicd.html). Currently only supporting Github.
33
33
 
34
34
  **Prerequisites:**
35
35
 
@@ -16,11 +16,11 @@ dependencies = [
16
16
  {%- endif %}
17
17
  "google-cloud-logging~=3.11.4",
18
18
  {%- if cookiecutter.deployment_target == 'cloud_run' %}
19
- "google-cloud-aiplatform[evaluation]~=1.91.0",
19
+ "google-cloud-aiplatform[evaluation]~=1.95.1",
20
20
  "fastapi~=0.115.8",
21
21
  "uvicorn~=0.34.0"
22
22
  {%- elif cookiecutter.deployment_target == 'agent_engine' %}
23
- "google-cloud-aiplatform[evaluation,agent-engines]~=1.91.0"
23
+ "google-cloud-aiplatform[evaluation,agent-engines]~=1.95.1"
24
24
  {%- endif %}
25
25
  ]
26
26
  {% if cookiecutter.deployment_target == 'cloud_run' %}
@@ -467,11 +467,19 @@ def _handle_credential_verification(creds_info: dict) -> dict:
467
467
  # Check if running in Cloud Shell
468
468
  if os.environ.get("CLOUD_SHELL") == "true":
469
469
  if creds_info["project"] == "":
470
- console.print("> It looks like you are running in Cloud Shell.")
471
470
  console.print(
472
- "> You need to set up a project ID to continue, but you haven't setup a project yet."
471
+ "> It looks like you are running in Cloud Shell.", style="bold blue"
473
472
  )
474
- new_project = Prompt.ask("\n> Enter a project ID")
473
+ console.print(
474
+ "> You need to set up a project ID to continue, but you haven't setup a project yet.",
475
+ style="bold blue",
476
+ )
477
+ new_project = Prompt.ask("\n> Enter a project ID", default=None)
478
+ while not new_project:
479
+ console.print(
480
+ "> Project ID cannot be empty. Please try again.", style="bold red"
481
+ )
482
+ new_project = Prompt.ask("\n> Enter a project ID", default=None)
475
483
  creds_info["project"] = new_project
476
484
  set_gcp_project(creds_info["project"], set_quota_project=False)
477
485
  return creds_info
@@ -19,8 +19,8 @@ Follow these steps to execute load tests:
19
19
 
20
20
  ```bash
21
21
  # Create and activate virtual environment
22
- python3 -m venv locust_env
23
- source locust_env/bin/activate
22
+ python3 -m venv .locust_env
23
+ source .locust_env/bin/activate
24
24
 
25
25
  # Install required packages
26
26
  pip install locust==2.31.1 "google-cloud-aiplatform[langchain,reasoningengine]>=1.77.0"
@@ -32,7 +32,7 @@ provider.add_span_processor(processor)
32
32
  trace.set_tracer_provider(provider)
33
33
 
34
34
  AGENT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
35
- app: FastAPI = get_fast_api_app(agent_dir=AGENT_DIR, web=False)
35
+ app: FastAPI = get_fast_api_app(agents_dir=AGENT_DIR, web=True)
36
36
 
37
37
  app.title = "{{cookiecutter.project_name}}"
38
38
  app.description = "API for interacting with the Agent {{cookiecutter.project_name}}"
@@ -18,7 +18,7 @@ uv run uvicorn app.server:app --host 0.0.0.0 --port 8000 --reload
18
18
  Using another terminal tab, This is suggested to avoid conflicts with the existing application python environment.
19
19
 
20
20
  ```bash
21
- python3 -m venv locust_env && source locust_env/bin/activate && pip install locust==2.31.1
21
+ python3 -m venv .locust_env && source locust_env/bin/activate && pip install locust==2.31.1
22
22
  ```
23
23
 
24
24
  **3. Execute the Load Test:**
@@ -69,7 +69,7 @@ export _ID_TOKEN=$(gcloud auth print-identity-token -q)
69
69
  **3. Execute the Load Test:**
70
70
  Create virtual environment with Locust:
71
71
  ```bash
72
- python3 -m venv locust_env && source locust_env/bin/activate && pip install locust==2.31.1
72
+ python3 -m venv .locust_env && source locust_env/bin/activate && pip install locust==2.31.1
73
73
  ```
74
74
 
75
75
  Execute load tests. The following command executes the same load test parameters as the local test but targets your remote Cloud Run instance.
@@ -253,10 +253,19 @@ class EventProcessor:
253
253
  msg = f"\n\nTool response: `{content}`"
254
254
  self.stream_handler.new_status(msg)
255
255
 
256
- # Handle AI responses
257
- elif content := message.get("content"):
258
- self.final_content += content
259
- self.stream_handler.new_token(content)
256
+ # Handle incremental AI response chunks
257
+ # These are partial content pieces that need to be accumulated
258
+ elif (
259
+ message.get("content")
260
+ and message.get("type") == "AIMessageChunk"
261
+ ):
262
+ self.final_content += message.get("content")
263
+ self.stream_handler.new_token(message.get("content"))
264
+
265
+ # Handle complete AI responses
266
+ # This is used when receiving a full message rather than chunks
267
+ elif message.get("content") and message.get("type") == "ai":
268
+ self.final_content = message.get("content")
260
269
 
261
270
  # Handle end of stream
262
271
  if self.final_content:
@@ -7,9 +7,7 @@
7
7
 
8
8
  # Use https://search.nixos.org/packages to find packages
9
9
  packages = [
10
- pkgs.python311
11
- pkgs.python311Packages.pip
12
- pkgs.python311Packages.uv
10
+ pkgs.uv
13
11
  pkgs.gnumake
14
12
  pkgs.terraform
15
13
  pkgs.gh
@@ -36,13 +34,8 @@
36
34
  echo "Setting gcloud project..."
37
35
  gcloud config set project $GOOGLE_CLOUD_PROJECT
38
36
 
39
- echo "Creating Python virtual environment and installing packages..."
40
- uv venv && uv pip install agent-starter-pack
41
- echo "alias agent-starter-pack=\"~/$WS_NAME/.venv/bin/agent-starter-pack\"" >> ~/.bashrc
42
- source ~/.bashrc
43
-
44
37
  echo "Running agent starter pack creation..."
45
- uv run agent-starter-pack create $AGENT_NAME
38
+ uvx agent-starter-pack create $AGENT_NAME
46
39
  code ~/$WS_NAME/$AGENT_NAME/README.md
47
40
  exec bash
48
41
  '';