agent-starter-pack 0.3.2__py3-none-any.whl → 0.3.3__py3-none-any.whl

{agent_starter_pack-0.3.2.dist-info → agent_starter_pack-0.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.3.2
+Version: 0.3.3
 Summary: CLI tool to create GCP-based AI agent projects from templates
 Author-email: Google LLC <agent-starter-pack@google.com>
 License: Apache-2.0
@@ -25,7 +25,20 @@ Description-Content-Type: text/markdown
 
 # 🚀 Agent Starter Pack
 
-![Version](https://img.shields.io/pypi/v/agent-starter-pack?color=blue) [![1-Minute Video Overview](https://img.shields.io/badge/1--Minute%20Overview-gray)](https://youtu.be/jHt-ZVD660g) [![Docs](https://img.shields.io/badge/Documentation-gray)](./docs/README.md) ![Stars](https://img.shields.io/github/stars/GoogleCloudPlatform/agent-starter-pack?color=yellow)
+![Version](https://img.shields.io/pypi/v/agent-starter-pack?color=blue) [![1-Minute Video Overview](https://img.shields.io/badge/1--Minute%20Overview-gray)](https://youtu.be/jHt-ZVD660g) [![Docs](https://img.shields.io/badge/Documentation-gray)](./docs/README.md) <a href="https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Ffeat-add-firebase-studio-resources%2Fsrc%2Fresources%2Fidx">
+  <picture>
+    <source
+      media="(prefers-color-scheme: dark)"
+      srcset="https://cdn.firebasestudio.dev/btn/try_light_20.svg">
+    <source
+      media="(prefers-color-scheme: light)"
+      srcset="https://cdn.firebasestudio.dev/btn/try_dark_20.svg">
+    <img
+      height="20"
+      alt="Try in Firebase Studio"
+      src="https://cdn.firebasestudio.dev/btn/try_blue_20.svg">
+  </picture>
+</a> ![Stars](https://img.shields.io/github/stars/GoogleCloudPlatform/agent-starter-pack?color=yellow)
 
 
 The `agent-starter-pack` is a collection of production-ready Generative AI Agent templates built for Google Cloud. <br>
@@ -53,7 +66,7 @@ agent-starter-pack create my-awesome-agent
 ```
 
 **That's it!** You now have a fully functional agent project—complete with backend, frontend, and deployment infrastructure—ready for you to explore and customize.
-For more installation options, see the [Installation Guide](docs/installation.md).
+For more installation options, see the [Installation Guide](docs/installation.md).  You can also [try it in Firebase Studio](https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx) with zero setup.
 
 ---
 
@@ -63,7 +76,6 @@ For more installation options, see the [Installation Guide](docs/installation.md
 agent-starter-pack create my-agent -d agent_engine -a adk_base
 ```
 
-
 *See the [full list of options](docs/cli/create.md) for details.*
 
 ## 🤖 Agents

{agent_starter_pack-0.3.2.dist-info → agent_starter_pack-0.3.3.dist-info}/RECORD

@@ -34,9 +34,9 @@ agents/live_api/tests/integration/test_server_e2e.py,sha256=D2VETDIyTD2fQyQ6DXwL
 agents/live_api/tests/load_test/load_test.py,sha256=HHZyfC4gqiQtZVF_CbbxENGgWQccMLpwMv0IdoQ6cbQ,1275
 agents/live_api/tests/unit/test_server.py,sha256=_TjlgQgNkjerIaBGnu8P8_KB8ZlSolDcivALpUOn_Rw,4786
 src/base_template/.gitignore,sha256=mJKTZIcVdAFiIUQicRfPNGUg6WvwcfTEC2xbmAaU34g,2579
-src/base_template/Makefile,sha256=vxOfXc3ZH2re_AYbWVjOBAMPeOgEtjGTOHMhEwAMs_c,3690
+src/base_template/Makefile,sha256=3fFwDiasX0KBjxO17jqwvXY9IcWZyTBftr-d5wpwiTg,3725
 src/base_template/README.md,sha256=0dHYVT8IlG0eMd7dEelAaPyuyk5ZDHnKAvNV8x7TBEA,10397
-src/base_template/pyproject.toml,sha256=pLw8q6j3qQWcu6A3HUpwsT2p3BzfmM2RDxjwUgZ2ulQ,2865
+src/base_template/pyproject.toml,sha256=-B1gk9Yx1OxL88bGH4oklCcSo0zOTm7IxaUbPcIS5rg,2959
 src/base_template/app/__init__.py,sha256=UyAgc2l8nkVIUPUzL9hKR7EgzCsc2jSYcOcjHNNmpMU,59
 src/base_template/app/utils/tracing.py,sha256=2rv1Ukh2jTBENDwoghCItJ28l-Sjz9gMlzdojlVgJa4,6052
 src/base_template/app/utils/typing.py,sha256=DP5OZC3IGvqA1XbvWt8kI3gyAK3ZjzUSL5Ca17wNeLI,4249
@@ -151,23 +151,26 @@ src/frontends/streamlit_adk/frontend/utils/stream_handler.py,sha256=xKwiY1KLWQdD
 src/frontends/streamlit_adk/frontend/utils/title_summary.py,sha256=lmYJUIz99jWY1dTziUao554GJBHFQTzQBRvoEl-x020,4347
 src/resources/containers/data_processing/Dockerfile,sha256=VoB9d5yZiiWnqRfWrIq0gGNMzZg-eVy733OgP72ZgO0,950
 src/resources/containers/e2e-tests/Dockerfile,sha256=Q_aTyX_iaFY8j06XZkpMuggJnNO5daiLmmrvqaZHMxw,1611
-src/resources/locks/uv-adk_base-agent_engine.lock,sha256=syI9vNoQn5E82OuKH2XyPMjxd5NiaBdXjzARp-CP6u0,628425
-src/resources/locks/uv-adk_base-cloud_run.lock,sha256=TyGqfTb65fw2Dri6KH6SYQMDu4pOcMDqyERY0kn0K_Y,797636
-src/resources/locks/uv-agentic_rag-agent_engine.lock,sha256=hEJuGbmoOBqlyU3-cZ-bAtBMP4WPD92ap8vVi34nqyM,638035
-src/resources/locks/uv-agentic_rag-cloud_run.lock,sha256=3oJiJ1Ac7DRawQ6Hl6TzsU4FhRD383158RokHOxEGeo,807246
-src/resources/locks/uv-crewai_coding_crew-agent_engine.lock,sha256=OqYAP4kYOXwiFRrOFBeB593rU_U1eI2TQuFgI5gAy9E,734457
-src/resources/locks/uv-crewai_coding_crew-cloud_run.lock,sha256=4_6ZNQ7Q45lSmIVnWL8BRMSfPedkS9WSyk8ORoA6vpY,911344
-src/resources/locks/uv-langgraph_base_react-agent_engine.lock,sha256=r7vPXAjYM7Lk_J-Qnp590PCEtNsWYXNDLKGSEBGSZpA,611193
-src/resources/locks/uv-langgraph_base_react-cloud_run.lock,sha256=BiZP9gsmrlQ4ludBaXb14-_P0wbKp5ra9Nwn8QbYmJA,781686
-src/resources/locks/uv-live_api-cloud_run.lock,sha256=_iSIEzx3Wjq4OtsZFcQ7IYsOIHyvBc7YCy1Qta9jRH4,784743
+src/resources/idx/idx-template.json,sha256=cLt7jXQ5-16AGl9vxEoXALI6HVUFwGWG5i3v7fGqPvo,792
+src/resources/idx/idx-template.nix,sha256=sesHGev_PYtVDg0J5tHkg0OO7IR1Bz2iAtl_if3Ar3M,892
+src/resources/idx/.idx/dev.nix,sha256=rT_eW3cp7BluMQakqy_V_RGUu2yoZjymiZmfyN3_PnI,1927
+src/resources/locks/uv-adk_base-agent_engine.lock,sha256=G5NhnUl9Tr0X-GbBr21jTdDf5MVGxmWF_OI4AqC4wBM,629284
+src/resources/locks/uv-adk_base-cloud_run.lock,sha256=Dq2F08qkB3s2oqazqmLrnNLmgzqNb0UbJdChV0Fq4l0,798495
+src/resources/locks/uv-agentic_rag-agent_engine.lock,sha256=NUXZvdoJgzEI5NLoB_hoXgwVimEbXl0ByTMm-yNfNuM,638894
+src/resources/locks/uv-agentic_rag-cloud_run.lock,sha256=f8P14yRwvJWB3lyfWCEZzkFpq51WyLYIGa386S3_khE,808105
+src/resources/locks/uv-crewai_coding_crew-agent_engine.lock,sha256=cCOpHuY2BK8how94MRgw4EF1q-iBo5aXTv3V1Fr2w90,735316
+src/resources/locks/uv-crewai_coding_crew-cloud_run.lock,sha256=yu2Iu6ODcRFKJJ6FLHarsKuyFNOjh1EL6WOIg6fLP3I,912203
+src/resources/locks/uv-langgraph_base_react-agent_engine.lock,sha256=jYVXjvTeQ7ppxcmoUvQpjuh5dA9vgNifstKaD2WPsR8,612052
+src/resources/locks/uv-langgraph_base_react-cloud_run.lock,sha256=NlN4eNWymUxGAmOJ2rZVPBdicMllXvheS-_foJPe2fU,782545
+src/resources/locks/uv-live_api-cloud_run.lock,sha256=0DSriJlsVuTDIiTAqYOHW3yclNyVr-eZUOFTBM47pLQ,785602
 src/resources/setup_cicd/cicd_variables.tf,sha256=PMflYe1TzQi63LORHkmeCktTYzXFplJgxffNH4DtuAQ,1244
 src/resources/setup_cicd/github.tf,sha256=scTBgeZlCM74N-pzhVKsnTN0PX9a5GboNl1HN3-LlCM,2791
 src/resources/setup_cicd/providers.tf,sha256=Km4z6IJt7x7PLaa0kyZbBrO2m3lpuIJZFD5jB7QBfF0,1122
 src/utils/generate_locks.py,sha256=xu5IAhGGBPkVQGSJX4kk7_JNDwWJUEaXAHbmaQIohbg,4386
 src/utils/lock_utils.py,sha256=_QdzQtgIbCmJ87s046_i1g966slVNmvr3bJDeHbRQSM,2419
 src/utils/watch_and_rebuild.py,sha256=vP4yIiA7E_lj5sfQdJUl8TXas6V7msDg8XWUutAC05Q,6679
-agent_starter_pack-0.3.2.dist-info/METADATA,sha256=JDgsTYFzAC-s_GsOXtQe6IcaUsUnZoeQFvI5hUCE1R4,8018
-agent_starter_pack-0.3.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-agent_starter_pack-0.3.2.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
-agent_starter_pack-0.3.2.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-agent_starter_pack-0.3.2.dist-info/RECORD,,
+agent_starter_pack-0.3.3.dist-info/METADATA,sha256=vib_OuCrbGy10-Yc1sK-wZWYJOrgXBPLDkLS_XsuIxk,8828
+agent_starter_pack-0.3.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+agent_starter_pack-0.3.3.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
+agent_starter_pack-0.3.3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+agent_starter_pack-0.3.3.dist-info/RECORD,,

src/base_template/Makefile

@@ -1,6 +1,6 @@
 install:
 	@command -v uv >/dev/null 2>&1 || { echo "uv is not installed. Installing uv..."; curl -LsSf https://astral.sh/uv/0.6.12/install.sh | sh; source ~/.bashrc; }
-	uv sync --dev {% if cookiecutter.agent_name != 'live_api' %}--extra streamlit{%- endif %} --extra jupyter --frozen{% if cookiecutter.agent_name == 'live_api' %} && npm --prefix frontend install{%- endif %}
+	uv sync --dev{% if cookiecutter.agent_name != 'live_api' and "adk" not in cookiecutter.tags %} --extra streamlit{%- endif %} --extra jupyter --frozen{% if cookiecutter.agent_name == 'live_api' %} && npm --prefix frontend install{%- endif %}
 
 test:
 	uv run pytest tests/unit && uv run pytest tests/integration

src/base_template/pyproject.toml

@@ -37,12 +37,14 @@ dev = [
 ]
 
 [project.optional-dependencies]
+{% if cookiecutter.agent_name != 'live_api' and "adk" not in cookiecutter.tags %}
 streamlit = [
     "streamlit~=1.42.0",
     "streamlit-extras~=0.4.3",
     "extra-streamlit-components~=0.1.71",
     "streamlit-feedback~=0.1.3",
 ]
+{% endif %}
 jupyter = [
     "jupyter~=1.0.0",
 ]

src/resources/idx/.idx/dev.nix

@@ -0,0 +1,57 @@
+
+# To learn more about how to use Nix to configure your environment
+# see: https://firebase.google.com/docs/studio/customize-workspace
+{ pkgs, ... }: {
+  # Which nixpkgs channel to use.
+  channel = "stable-24.11"; # or "unstable"
+
+  # Use https://search.nixos.org/packages to find packages
+  packages = [
+    pkgs.python311
+    pkgs.python311Packages.pip
+    pkgs.python311Packages.uv
+    pkgs.gnumake
+    pkgs.terraform
+    pkgs.gh
+  ];
+  # Sets environment variables in the workspace
+  env = {};
+  idx = {
+    # Search for the extensions you want on https://open-vsx.org/ and use "publisher.id"
+    extensions = [
+      "ms-toolsai.jupyter"
+      "ms-python.python"
+      "krish-r.vscode-toggle-terminal"
+    ];
+    workspace = {
+      # Runs when a workspace is first created with this `dev.nix` file
+      onCreate = {
+        create-venv = ''
+        # Load environment variables from .env file if it exists
+        source .env
+        echo "Logging into gcloud..."
+        echo "Please authenticate with Google Cloud by following the prompts."
+        gcloud auth login --update-adc --brief --quiet
+
+        echo "Setting gcloud project..."
+        gcloud config set project $GOOGLE_CLOUD_PROJECT
+
+        echo "Creating Python virtual environment and installing packages..."
+        uv venv && uv pip install agent-starter-pack
+        echo "alias agent-starter-pack=\"~/$WS_NAME/.venv/bin/agent-starter-pack\"" >> ~/.bashrc
+        source ~/.bashrc
+
+        echo "Running agent starter pack creation..."
+        uv run agent-starter-pack create $AGENT_NAME
+        code ~/$WS_NAME/$AGENT_NAME/README.md
+        exec bash
+        '';
+        # Open editors for the following files by default, if they exist:
+        default.openFiles = [];
+      };
+      # To run something each time the workspace is (re)started, use the `onStart` hook
+    };
+    # Enable previews and customize configuration
+    previews = {};
+  };
+}

src/resources/idx/idx-template.json

@@ -0,0 +1,21 @@
+{
+  "name": "Agent Starter Pack",
+  "description": "Production-ready Gen AI Agent templates for Google Cloud. Addressing common challenges (Deployment & Operations, Evaluation, Customization, Observability) in building and deploying GenAI agents.",
+  "icon": "https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/images/icon.png?raw=true",
+  "params": [
+    {
+      "id": "agent_name",
+      "name": "Agent Name",
+      "description": "The name of the agent being created.",
+      "type": "string",
+      "required": true
+    },
+    {
+      "id": "google_cloud_project_id",
+      "name": "Your Goole Cloud Project ID",
+      "description": "The Google Cloud Platform Project ID where resources will be managed.",
+      "type": "string",
+      "required": true
+    }
+  ]
+}

src/resources/idx/idx-template.nix

@@ -0,0 +1,26 @@
+# No user-configurable parameters
+# Accept additional arguments to this template corresponding to template
+# parameter IDs
+{ pkgs, agent_name ? "", google_cloud_project_id ? "", ... }: {
+  # Shell script that produces the final environment
+  bootstrap = ''
+    # Copy the folder containing the `idx-template` files to the final
+    # project folder for the new workspace. ${./.} inserts the directory
+    # of the checked-out Git folder containing this template.
+    cp -rf ${./.} "$out"
+
+    # Set some permissions
+    chmod -R +w "$out"
+
+    # Create .env file with the parameter values
+    cat > "$out/.env" << EOF
+    AGENT_NAME=${agent_name}
+    GOOGLE_CLOUD_PROJECT=${google_cloud_project_id}
+    WS_NAME=$WS_NAME
+    EOF
+
+    # Remove the template files themselves and any connection to the template's
+    # Git repository
+    rm -rf "$out/.git" "$out/idx-template".{nix,json}
+  '';
+}