agent-starter-pack 0.3.2__tar.gz → 0.3.3__tar.gz

{agent_starter_pack-0.3.2 → agent_starter_pack-0.3.3}/PKG-INFO

@@ -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 → agent_starter_pack-0.3.3}/README.md

@@ -1,6 +1,19 @@
 # 🚀 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>
@@ -28,7 +41,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.
 
 ---
 
@@ -38,7 +51,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 → agent_starter_pack-0.3.3}/docs/installation.md

@@ -1,6 +1,6 @@
 # Installation
 
-There are several ways to install the Agent Starter Pack. Choose the method that works best for your workflow.
+There are several ways to install the Agent Starter Pack. Choose the method that works best for your workflow. 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%2Fid), a cloud-based development environment with zero setup. 
 
 ## Using pipx (Recommended)
 
@@ -35,7 +35,9 @@ For a faster installation experience, you can use [uv](https://astral.sh/uv):
 # Install uv if you don't have it
 curl -LsSf https://astral.sh/uv/install.sh | sh
 
-source ~/.bashrc  # or ~/.zshrc depending on your shell
+# For sh, bash, zsh
+# For fish: source $HOME/.local/bin/env.fish
+source $HOME/.local/bin/env 
 
 # Install the Agent Starter Pack
 uv pip install agent-starter-pack

{agent_starter_pack-0.3.2 → agent_starter_pack-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-starter-pack"
-version = "0.3.2"
+version = "0.3.3"
 description = "CLI tool to create GCP-based AI agent projects from templates"
 authors = [
     { name = "Google LLC", email = "agent-starter-pack@google.com" },

{agent_starter_pack-0.3.2 → agent_starter_pack-0.3.3}/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

{agent_starter_pack-0.3.2 → agent_starter_pack-0.3.3}/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",
 ]

agent_starter_pack-0.3.3/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 = {};
+  };
+}

agent_starter_pack-0.3.3/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
+    }
+  ]
+}

agent_starter_pack-0.3.3/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}
+  '';
+}