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.
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/PKG-INFO +2 -2
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/README.md +1 -1
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/template/.templateconfig.yaml +1 -1
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/tests/integration/test_agent.py +1 -1
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/template/.templateconfig.yaml +1 -1
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/tests/integration/test_agent.py +1 -1
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/app/server.py +5 -1
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/cli/setup_cicd.md +8 -5
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/deployment.md +1 -1
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/development-guide.md +2 -2
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/getting-started.md +7 -8
- agent_starter_pack-0.5.1/docs/guide/installation.md +151 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/pyproject.toml +1 -1
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/README.md +2 -2
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/README.md +1 -1
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/pyproject.toml +2 -2
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/commands/create.py +11 -3
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/tests/load_test/README.md +2 -2
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/app/server.py +1 -1
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/tests/load_test/README.md +2 -2
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/stream_handler.py +13 -4
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/idx/.idx/dev.nix +2 -9
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-adk_base-agent_engine.lock +340 -334
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-adk_base-cloud_run.lock +412 -405
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-agentic_rag-agent_engine.lock +531 -522
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-agentic_rag-cloud_run.lock +683 -665
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-crewai_coding_crew-agent_engine.lock +678 -629
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-crewai_coding_crew-cloud_run.lock +833 -773
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-langgraph_base_react-agent_engine.lock +647 -571
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-langgraph_base_react-cloud_run.lock +826 -730
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/locks/uv-live_api-cloud_run.lock +160 -159
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_utils/test_stream_handler.py +77 -18
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/uv.lock +2580 -2580
- agent_starter_pack-0.4.5/docs/guide/installation.md +0 -74
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/cd/test_e2e.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/ci/build_use_wheel.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/ci/lint.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/ci/lint_templated_agents.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/ci/test.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/ci/test_templated_agents.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/terraform/apis.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/terraform/build_triggers.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/terraform/service_account.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/terraform/storage.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.cloudbuild/terraform/variables.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.github/workflows/docs.yml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/.gitignore +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/CODE_OF_CONDUCT.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/CONTRIBUTING.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/LICENSE +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/Makefile +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/README.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/app/agent.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/notebooks/adk_app_testing.ipynb +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/notebooks/evaluating_adk_agent.ipynb +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/README.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/app/agent.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/app/retrievers.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/app/templates.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/notebooks/adk_app_testing.ipynb +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/agentic_rag/notebooks/evaluating_adk_agent.ipynb +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/README.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/app/agent.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/app/crew/config/agents.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/app/crew/config/tasks.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/app/crew/crew.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/notebooks/evaluating_crewai_agent.ipynb +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/notebooks/evaluating_langgraph_agent.ipynb +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/template/.templateconfig.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/crewai_coding_crew/tests/integration/test_agent.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/langgraph_base_react/README.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/langgraph_base_react/app/agent.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/langgraph_base_react/notebooks/evaluating_langgraph_agent.ipynb +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/langgraph_base_react/template/.templateconfig.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/langgraph_base_react/tests/integration/test_agent.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/README.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/app/agent.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/template/.templateconfig.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/tests/integration/test_server_e2e.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/tests/load_test/load_test.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/live_api/tests/unit/test_server.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/.vitepress/config.js +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/agents/overview.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/cli/create.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/cli/index.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/data-ingestion.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/observability.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/troubleshooting.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/video-tutorials.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/guide/why_starter_pack.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/adk_logo.png +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/agent_starter_pack_screenshot.png +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/ags_high_level_architecture.png +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/icon.png +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/logo.png +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/prototype_to_prod.png +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/why_sp_edited.png +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/images/why_starter_pack.png +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/index.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/package-lock.json +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/docs/package.json +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/.gitignore +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/Makefile +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/app/__init__.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/app/utils/tracing.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/app/utils/typing.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/cd/deploy-to-prod.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/cd/staging.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/ci/pr_checks.yaml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/apis.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/build_triggers.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/apis.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/iam.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/log_sinks.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/providers.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/storage.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/variables.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/dev/vars/env.tfvars +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/iam.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/locals.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/log_sinks.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/providers.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/service_accounts.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/storage.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/variables.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/terraform/vars/env.tfvars +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/tests/unit/test_dummy.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/commands/setup_cicd.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/main.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/__init__.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/cicd.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/datastores.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/gcp.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/logging.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/template.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/cli/utils/version.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/README.md +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/data_ingestion_pipeline/components/ingest_data.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/data_ingestion_pipeline/components/process_data.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/data_ingestion_pipeline/pipeline.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/data_ingestion_pipeline/submit_pipeline.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/pyproject.toml +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/data_ingestion/uv.lock +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/app/agent_engine_app.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/app/utils/gcs.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/deployment_metadata.json +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/notebooks/intro_agent_engine.ipynb +0 -0
- {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
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/agent_engine/tests/load_test/.results/.placeholder +0 -0
- {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
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/Dockerfile +0 -0
- {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
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/tests/load_test/.results/.placeholder +0 -0
- {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
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/uv.lock +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/package-lock.json +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/package.json +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/public/favicon.ico +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/public/index.html +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/public/robots.txt +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/App.scss +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/App.test.tsx +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/App.tsx +0 -0
- {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
- {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
- {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
- {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
- {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
- {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
- {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
- {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
- {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
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/contexts/LiveAPIContext.tsx +0 -0
- {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
- {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
- {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
- {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
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/index.css +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/index.tsx +0 -0
- {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
- {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
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/reportWebVitals.ts +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/setupTests.ts +0 -0
- {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
- {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
- {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
- {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
- {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
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/src/utils/utils.ts +0 -0
- {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
- {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
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/live_api_react/frontend/tsconfig.json +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/side_bar.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/streamlit_app.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/style/app_markdown.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/chat_utils.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/local_chat_history.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/message_editing.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/multimodal_utils.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit/frontend/utils/title_summary.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/side_bar.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/streamlit_app.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/style/app_markdown.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/chat_utils.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/local_chat_history.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/message_editing.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/multimodal_utils.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/stream_handler.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/frontends/streamlit_adk/frontend/utils/title_summary.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/containers/data_processing/Dockerfile +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/containers/e2e-tests/Dockerfile +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/idx/idx-template.json +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/idx/idx-template.nix +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/setup_cicd/cicd_variables.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/setup_cicd/github.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/resources/setup_cicd/providers.tf +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/utils/generate_locks.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/utils/lock_utils.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/utils/watch_and_rebuild.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/__init__.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/cicd/example.env +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/cicd/test_e2e_deployment.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/cli/commands/test_create.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/cli/commands/test_setup_cicd.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/cli/utils/test_cicd.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/integration/test_template_linting.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/integration/test_templated_patterns.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_side_bar.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_streamlit_app.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_utils/test_chat_utils.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_utils/test_local_chat_history.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_utils/test_message_editing.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/test_frontend/test_utils/test_multimodal_utils.py +0 -0
- {agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/tests/utils/__init__.py +0 -0
- {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.
|
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
|
{agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/agents/adk_base/template/.templateconfig.yaml
RENAMED
@@ -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~=
|
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.
|
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~=
|
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.
|
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(
|
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
|
-
|
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](
|
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
|
-
|
68
|
-
|
69
|
-
|
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.
|
@@ -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.
|
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.
|
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
|
|
{agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/base_template/deployment/README.md
RENAMED
@@ -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.
|
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.
|
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.
|
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
|
-
">
|
471
|
+
"> It looks like you are running in Cloud Shell.", style="bold blue"
|
473
472
|
)
|
474
|
-
|
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"
|
{agent_starter_pack-0.4.5 → agent_starter_pack-0.5.1}/src/deployment_targets/cloud_run/app/server.py
RENAMED
@@ -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(
|
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
|
257
|
-
|
258
|
-
|
259
|
-
|
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.
|
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
|
-
|
38
|
+
uvx agent-starter-pack create $AGENT_NAME
|
46
39
|
code ~/$WS_NAME/$AGENT_NAME/README.md
|
47
40
|
exec bash
|
48
41
|
'';
|