agent-starter-pack 0.5.0__tar.gz → 0.5.2__tar.gz

{agent_starter_pack-0.5.0 → agent_starter_pack-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.5.0
+Version: 0.5.2
 Summary: CLI to bootstrap production-ready Google Cloud GenAI agent projects from templates.
 Author-email: Google LLC <agent-starter-pack@google.com>
 License: Apache-2.0
@@ -9,7 +9,7 @@ Requires-Python: >=3.10
 Requires-Dist: backoff>=2.2.1
 Requires-Dist: click~=8.1.7
 Requires-Dist: cookiecutter~=2.5.0
-Requires-Dist: google-cloud-aiplatform~=1.87.0
+Requires-Dist: google-cloud-aiplatform>=1.95.0
 Requires-Dist: pyyaml~=6.0.1
 Requires-Dist: rich~=13.7.0
 Provides-Extra: jupyter

{agent_starter_pack-0.5.0 → agent_starter_pack-0.5.2}/agents/adk_base/template/.templateconfig.yaml

@@ -17,6 +17,6 @@ example_question: "What's the weather in San Francisco?"
 settings:
   requires_data_ingestion: false
   deployment_targets: ["agent_engine", "cloud_run"]
-  extra_dependencies: ["google-adk~=1.1.0"]
+  extra_dependencies: ["google-adk~=1.2.0"]
   tags: ["adk"]
   frontend_type: "None"

{agent_starter_pack-0.5.0 → agent_starter_pack-0.5.2}/agents/agentic_rag/template/.templateconfig.yaml

@@ -18,7 +18,7 @@ settings:
   requires_data_ingestion: true
   deployment_targets: ["agent_engine", "cloud_run"]
   extra_dependencies: [
-    "google-adk~=1.1.0",
+    "google-adk~=1.2.0",
     "langchain-google-vertexai~=2.0.7",
     "langchain~=0.3.24",
     "langchain-core~=0.3.55",

agent_starter_pack-0.5.2/docs/guide/installation.md

@@ -0,0 +1,151 @@
+# Installation
+
+There are several ways to install the Agent Starter Pack. Choose the method that works best for your workflow.
+
+**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)
+
+## `uvx` for Quick Project Creation
+
+If you have [uv](https://astral.sh/uv) installed, you can create projects without a permanent installation:
+```bash
+uvx agent-starter-pack create my-awesome-agent
+```
+
+## Virtual Environment Installation
+
+Installs into an isolated Python environment.
+
+```bash
+# Create and activate venv
+python -m venv .venv && source .venv/bin/activate # source .venv/Scripts/activate for Windows Git Bash
+
+# Install using pip or uv
+pip install agent-starter-pack
+```
+
+## Persistent CLI Installation
+
+Installs the `agent-starter-pack` command globally.
+
+### With `pipx` (Isolated Global Tool)
+```bash
+# Install pipx (if needed)
+python3 -m pip install --user pipx && python3 -m pipx ensurepath
+
+# Install Agent Starter Pack
+pipx install agent-starter-pack
+```
+
+### With `uv tool install` (Fast, Isolated Global Tool)
+Requires `uv` (see `uvx` section for install).
+```bash
+uv tool install agent-starter-pack
+```
+
+## Create Project (After Persistent/Venv Install)
+
+If you installed via `pipx`, `uv tool install`, or in a virtual environment:
+```bash
+agent-starter-pack create my-awesome-agent
+```
+
+## Managing Installation
+
+### Upgrading
+*   **`uvx`:** Not needed (always uses latest).
+*   **`pipx`:** `pipx upgrade agent-starter-pack`
+*   **`uv tool`:** `uv tool install agent-starter-pack` (this upgrades)
+*   **`pip`/`uv pip` (in .venv):** `(uv) pip install --upgrade agent-starter-pack`
+
+### Uninstalling
+*   **`uvx`:** Not applicable.
+*   **`pipx`:** `pipx uninstall agent-starter-pack`
+*   **`uv tool`:** `uv tool uninstall agent-starter-pack`
+*   **`pip`/`uv pip` (in .venv):** `(uv) pip uninstall agent-starter-pack`
+
+## Troubleshooting Common Installation Issues
+
+### Command Not Found After Installation
+
+If you encounter "command not found" errors after installation:
+
+1.  **Check your PATH**: Ensure that the Python scripts directory is in your PATH:
+    ```bash
+    echo $PATH
+    ```
+2.  **Verify installation location**: Check where the package was installed:
+    ```bash
+    pip show agent-starter-pack
+    ```
+3.  **Manual path addition**: If needed, add the scripts directory to your PATH:
+    ```bash
+    export PATH="$HOME/.local/bin:$PATH"
+    # For user installations
+    ```
+    Add this line to your `~/.bashrc` or `~/.zshrc` for persistence.
+
+### Permission Errors During Installation
+
+If you encounter permission errors:
+
+1.  **Use user installation mode**:
+    ```bash
+    pip install --user agent-starter-pack
+    ```
+2.  **Check directory permissions**:
+    ```bash
+    ls -la ~/.local/bin
+    ```
+3.  **Fix permissions if needed**:
+    ```bash
+    chmod +x ~/.local/bin/agent-starter-pack
+    ```
+
+### Python Version Compatibility Issues
+
+If you encounter Python version errors:
+
+1.  **Check your Python version**:
+    ```bash
+    python --version
+    ```
+2.  **Install a compatible Python version** if needed (3.10 or newer is required).
+3.  **Create a virtual environment with the correct Python version**:
+    ```bash
+    python3.10 -m venv .venv
+    source .venv/bin/activate
+    ```
+
+### Package Dependency Conflicts
+
+If you encounter dependency conflicts:
+
+1.  **Use a clean virtual environment**:
+    ```bash
+    python -m venv .venv
+    source .venv/bin/activate
+    pip install agent-starter-pack
+    ```
+2.  **Update pip and setuptools**:
+    ```bash
+    pip install --upgrade pip setuptools
+    ```
+3.  **Install with verbose output to identify conflicts**:
+    ```bash
+    pip install -v agent-starter-pack
+    ```
+
+### Installation Verification
+
+To verify your installation is working correctly:
+
+1.  **Check the installed version**:
+    ```bash
+    agent-starter-pack --version
+    ```
+2.  **Run the help command**:
+    ```bash
+    agent-starter-pack --help
+    ```
+
+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.

{agent_starter_pack-0.5.0 → agent_starter_pack-0.5.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-starter-pack"
-version = "0.5.0"
+version = "0.5.2"
 description = "CLI to bootstrap production-ready Google Cloud GenAI agent projects from templates."
 authors = [
     { name = "Google LLC", email = "agent-starter-pack@google.com" },
@@ -11,7 +11,7 @@ requires-python = ">=3.10"
 dependencies = [
     "click~=8.1.7",
     "cookiecutter~=2.5.0",
-    "google-cloud-aiplatform~=1.87.0",
+    "google-cloud-aiplatform>=1.95.0",
     "rich~=13.7.0",
     "pyyaml~=6.0.1",
     "backoff>=2.2.1",

{agent_starter_pack-0.5.0 → agent_starter_pack-0.5.2}/src/base_template/README.md

@@ -49,7 +49,7 @@ make install && make playground
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
 | `make playground`    | Launch local development environment with backend and frontend{%- if "adk" in cookiecutter.tags %} - leveraging `adk web` command. {%- endif %}|
 | `make backend`       | Deploy agent to Cloud Run |
-| `make local-backend`       | Deploy agent to Cloud Run |
+| `make local-backend` | Launch local development server |
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
 {%- if cookiecutter.agent_name == 'live_api' %}
 | `make ui`       | Launch Agent Playground front-end only |

{agent_starter_pack-0.5.0 → agent_starter_pack-0.5.2}/src/frontends/streamlit/frontend/utils/stream_handler.py

@@ -253,10 +253,19 @@ class EventProcessor:
                         msg = f"\n\nTool response: `{content}`"
                         self.stream_handler.new_status(msg)
 
-                    # Handle AI responses
-                    elif content := message.get("content"):
-                        self.final_content += content
-                        self.stream_handler.new_token(content)
+                    # Handle incremental AI response chunks
+                    # These are partial content pieces that need to be accumulated
+                    elif (
+                        message.get("content")
+                        and message.get("type") == "AIMessageChunk"
+                    ):
+                        self.final_content += message.get("content")
+                        self.stream_handler.new_token(message.get("content"))
+
+                    # Handle complete AI responses
+                    # This is used when receiving a full message rather than chunks
+                    elif message.get("content") and message.get("type") == "ai":
+                        self.final_content = message.get("content")
 
         # Handle end of stream
         if self.final_content: