agent-starter-pack 0.0.9b0__tar.gz → 0.0.11b0__tar.gz

{agent_starter_pack-0.0.9b0 → agent_starter_pack-0.0.11b0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.0.9b0
+Version: 0.0.11b0
 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
@@ -9,7 +9,6 @@ Requires-Python: >=3.10
 Requires-Dist: click~=8.1.7
 Requires-Dist: cookiecutter~=2.5.0
 Requires-Dist: google-cloud-aiplatform~=1.81.0
-Requires-Dist: inquirer~=3.1.3
 Requires-Dist: pyyaml~=6.0.1
 Requires-Dist: rich~=13.7.0
 Provides-Extra: jupyter

{agent_starter_pack-0.0.9b0 → agent_starter_pack-0.0.11b0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-starter-pack"
-version = "0.0.9b"
+version = "0.0.11b"
 description = "CLI tool to create GCP-based AI agent projects from templates"
 authors = [
     { name = "Google LLC", email = "agent-starter-pack@google.com" },
@@ -12,7 +12,6 @@ dependencies = [
     "click~=8.1.7",
     "cookiecutter~=2.5.0",
     "google-cloud-aiplatform~=1.81.0",
-    "inquirer~=3.1.3",
     "rich~=13.7.0",
     "pyyaml~=6.0.1",
 ]

{agent_starter_pack-0.0.9b0 → agent_starter_pack-0.0.11b0}/src/base_template/Makefile

@@ -1,9 +1,10 @@
-test:
-	uv run pytest tests/unit && uv run pytest tests/integration
-
 install:
+	@command -v uv >/dev/null 2>&1 || { echo "uv is not installed. Installing uv..."; curl -LsSf https://astral.sh/uv/install.sh | sh; source ~/.bashrc; }
 	uv sync --dev {% if cookiecutter.agent_name != 'multimodal_live_api' %}--extra streamlit{%- endif %} --extra jupyter --frozen{% if cookiecutter.agent_name == 'multimodal_live_api' %} && npm --prefix frontend install{%- endif %}
 
+test:
+	uv run pytest tests/unit && uv run pytest tests/integration
+
 playground:
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
 	uv run uvicorn app.server:app --host 0.0.0.0 --port 8000 --reload &

{agent_starter_pack-0.0.9b0 → agent_starter_pack-0.0.11b0}/src/base_template/README.md

@@ -21,6 +21,14 @@ This project is organized as follows:
 └── pyproject.toml       # Project dependencies and configuration
 ```
 
+## Requirements
+
+Before you begin, ensure you have:
+- **uv**: Python package manager - [Install](https://docs.astral.sh/uv/getting-started/installation/)
+- **Google Cloud SDK**: For GCP services - [Install](https://cloud.google.com/sdk/docs/install)
+- **Terraform**: For infrastructure deployment - [Install](https://developer.hashicorp.com/terraform/downloads)
+- **make**: Build automation tool - [Install](https://www.gnu.org/software/make/) (pre-installed on most Unix-based systems)
+
 
 ### Installation
 
@@ -30,7 +38,7 @@ Install required packages using uv:
 uv sync --extra jupyter --extra streamlit --frozen
 ```
 
-### Setup
+### Setupx
 
 If not done during the initialization, set your default Google Cloud project and Location:
 
@@ -46,15 +54,17 @@ gcloud auth application-default set-quota-project $PROJECT_ID
 
 | Command              | Description                                                                                 |
 | -------------------- | ------------------------------------------------------------------------------------------- |
+| `make install`       | Install all required dependencies using uv                                                  |
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
 | `make playground`    | Launch local development environment with backend and frontend |
 | `make backend`       | Start backend server only |
-| `make ui`           | Launch Streamlit frontend without local backend |
+| `make ui`            | Launch Streamlit frontend without local backend |
 {%- elif cookiecutter.deployment_target == 'agent_engine' %}
 | `make playground`    | Launch Streamlit interface for testing agent locally and remotely |
 | `make backend`       | Deploy agent to Agent Engine service |
 {%- endif %}
 | `make test`          | Run unit and integration tests                                                              |
+| `make lint`          | Run code quality checks (codespell, ruff, mypy)                                             |
 | `uv run jupyter lab` | Launch Jupyter notebook                                                                     |
 
 For full command options and usage, refer to the [Makefile](Makefile).

{agent_starter_pack-0.0.9b0 → agent_starter_pack-0.0.11b0}/src/cli/commands/create.py

@@ -165,8 +165,6 @@ def create(
 
         # Check for uv installation if not skipping checks
         if not skip_checks:
-            check_and_install_uv()
-
             # Set up GCP environment
             try:
                 setup_gcp_environment(
@@ -178,6 +176,17 @@ def create(
             except Exception as e:
                 if debug:
                     logging.warning(f"GCP environment setup failed: {e}")
+                console.print(
+                    f"> Warning: GCP environment setup failed: {e}", style="yellow"
+                )
+                console.print(
+                    "> Please check your authentication settings and permissions. "
+                    "Visit https://cloud.google.com/vertex-ai/docs/authentication for help.",
+                    style="yellow",
+                )
+                console.print(
+                    "> Continuing with template processing...", style="yellow"
+                )
 
         # Process template
         template_path = get_template_path(final_agent, debug=debug)
@@ -527,26 +536,3 @@ def replace_region_in_files(
         except UnicodeDecodeError:
             # Skip files that can't be read as text
             continue
-
-
-def check_and_install_uv() -> None:
-    """Check if uv is installed and inform the user if it's not."""
-    try:
-        # Use shell=True for Windows compatibility and add timeout
-        process = subprocess.run(
-            "uv --version", shell=True, capture_output=True, text=True, timeout=5
-        )
-        if process.returncode == 0:
-            logging.debug("uv is already installed")
-            return
-        else:
-            console.print("> uv command failed", style="yellow")
-    except subprocess.TimeoutExpired:
-        console.print("> uv version check timed out", style="yellow")
-    except (subprocess.CalledProcessError, FileNotFoundError):
-        console.print("> uv is not installed", style="yellow")
-
-    console.print(
-        "\n> uv is recommended for managing virtual environments and dependencies."
-        "\n> For installation instructions, visit: https://docs.astral.sh/uv/getting-started/installation"
-    )

agent_starter_pack-0.0.11b0/src/cli/main.py

@@ -0,0 +1,57 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import importlib.metadata
+
+import click
+from rich.console import Console
+
+from .commands.create import create
+from .commands.setup_cicd import setup_cicd
+
+console = Console()
+
+
+def print_version(ctx: click.Context, param: click.Parameter, value: bool) -> None:
+    if not value or ctx.resilient_parsing:
+        return
+    try:
+        version_str = importlib.metadata.version("agent-starter-pack")
+        console.print(f"GCP Agent Starter Pack CLI version: {version_str}")
+    except importlib.metadata.PackageNotFoundError:
+        console.print("GCP Agent Starter Pack CLI (development version)")
+    ctx.exit()
+
+
+@click.group(help="Production-ready Generative AI Agent templates for Google Cloud")
+@click.option(
+    "--version",
+    "-v",
+    is_flag=True,
+    callback=print_version,
+    expose_value=False,
+    is_eager=True,
+    help="Show the version and exit.",
+)
+def cli() -> None:
+    pass
+
+
+# Register commands
+cli.add_command(create)
+cli.add_command(setup_cicd)
+
+
+if __name__ == "__main__":
+    cli()

{agent_starter_pack-0.0.9b0 → agent_starter_pack-0.0.11b0}/tests/cli/commands/test_create.py

@@ -95,13 +95,6 @@ def mock_verify_vertex_connection() -> Generator[MagicMock, None, None]:
         yield mock
 
 
-@pytest.fixture
-def mock_check_and_install_uv() -> Generator[MagicMock, None, None]:
-    """Mock the UV installation check"""
-    with patch("src.cli.commands.create.check_and_install_uv") as mock:
-        yield mock
-
-
 @pytest.fixture
 def mock_subprocess() -> Generator[MagicMock, None, None]:
     with patch("src.cli.commands.create.subprocess.run") as mock:
@@ -191,7 +184,6 @@ class TestCreateCommand:
         mock_mkdir: MagicMock,
         mock_resolve: MagicMock,
         mock_verify_vertex_connection: MagicMock,
-        mock_check_and_install_uv: MagicMock,
     ) -> None:
         """Test create command with all options provided"""
         runner = CliRunner()
@@ -259,7 +251,6 @@ class TestCreateCommand:
         mock_mkdir: MagicMock,
         mock_resolve: MagicMock,
         mock_verify_vertex_connection: MagicMock,
-        mock_check_and_install_uv: MagicMock,
     ) -> None:
         """Test create command with auto-approve flag"""
         runner = CliRunner()
@@ -317,7 +308,6 @@ class TestCreateCommand:
         mock_mkdir: MagicMock,
         mock_resolve: MagicMock,
         mock_verify_vertex_connection: MagicMock,
-        mock_check_and_install_uv: MagicMock,
     ) -> None:
         """Test create command in interactive mode"""
         runner = CliRunner()
@@ -367,7 +357,6 @@ class TestCreateCommand:
         mock_mkdir: MagicMock,
         mock_resolve: MagicMock,
         mock_verify_vertex_connection: MagicMock,
-        mock_check_and_install_uv: MagicMock,
     ) -> None:
         """Test create command with GCP credential change"""
         runner = CliRunner()
@@ -382,7 +371,9 @@ class TestCreateCommand:
         mock_subprocess.side_effect = [
             MagicMock(returncode=0),  # gcloud auth login
             MagicMock(returncode=0),  # gcloud config set project
-            MagicMock(returncode=0),  # gcloud auth application-default set-quota-project
+            MagicMock(
+                returncode=0
+            ),  # gcloud auth application-default set-quota-project
         ]
 
         with (
@@ -412,8 +403,7 @@ class TestCreateCommand:
 
         # Verify subprocess was called with the right arguments for login
         mock_subprocess.assert_any_call(
-            ["gcloud", "auth", "login", "--update-adc"], 
-            check=True
+            ["gcloud", "auth", "login", "--update-adc"], check=True
         )
 
     def test_create_with_invalid_agent_name(

{agent_starter_pack-0.0.9b0 → agent_starter_pack-0.0.11b0}/uv.lock

@@ -11,13 +11,12 @@ resolution-markers = [
 
 [[package]]
 name = "agent-starter-pack"
-version = "0.0.8b0"
+version = "0.0.11b0"
 source = { editable = "." }
 dependencies = [
     { name = "click" },
     { name = "cookiecutter" },
     { name = "google-cloud-aiplatform" },
-    { name = "inquirer" },
     { name = "pyyaml" },
     { name = "rich" },
 ]
@@ -69,7 +68,6 @@ requires-dist = [
     { name = "codespell", marker = "extra == 'lint'", specifier = "~=2.2.0" },
     { name = "cookiecutter", specifier = "~=2.5.0" },
     { name = "google-cloud-aiplatform", specifier = "~=1.81.0" },
-    { name = "inquirer", specifier = "~=3.1.3" },
     { name = "ipykernel", marker = "extra == 'jupyter'", specifier = ">=6.29.5" },
     { name = "jupyter", marker = "extra == 'jupyter'" },
     { name = "mypy", marker = "extra == 'lint'", specifier = "~=1.15.0" },
@@ -246,15 +244,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643 },
 ]
 
-[[package]]
-name = "ansicon"
-version = "1.89.0"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/b6/e2/1c866404ddbd280efedff4a9f15abfe943cb83cde6e895022370f3a61f85/ansicon-1.89.0.tar.gz", hash = "sha256:e4d039def5768a47e4afec8e89e83ec3ae5a26bf00ad851f914d1240b444d2b1", size = 67312 }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/75/f9/f1c10e223c7b56a38109a3f2eb4e7fe9a757ea3ed3a166754fb30f65e466/ansicon-1.89.0-py2.py3-none-any.whl", hash = "sha256:f1def52d17f65c2c9682cf8370c03f541f410c1752d6a14029f97318e4b9dfec", size = 63675 },
-]
-
 [[package]]
 name = "anyascii"
 version = "0.3.2"
@@ -540,20 +529,6 @@ css = [
     { name = "tinycss2" },
 ]
 
-[[package]]
-name = "blessed"
-version = "1.20.0"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "jinxed", marker = "sys_platform == 'win32'" },
-    { name = "six" },
-    { name = "wcwidth" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/25/ae/92e9968ad23205389ec6bd82e2d4fca3817f1cdef34e10aa8d529ef8b1d7/blessed-1.20.0.tar.gz", hash = "sha256:2cdd67f8746e048f00df47a2880f4d6acbcdb399031b604e34ba8f71d5787680", size = 6655612 }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/76/98/584f211c3a4bb38f2871fa937ee0cc83c130de50c955d6c7e2334dbf4acb/blessed-1.20.0-py2.py3-none-any.whl", hash = "sha256:0c542922586a265e699188e52d5f5ac5ec0dd517e5a1041d90d2bbf23f906058", size = 58372 },
-]
-
 [[package]]
 name = "blinker"
 version = "1.9.0"
@@ -1873,20 +1848,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ef/a6/62565a6e1cf69e10f5727360368e451d4b7f58beeac6173dc9db836a5b46/iniconfig-2.0.0-py3-none-any.whl", hash = "sha256:b6a85871a79d2e3b22d2d1b94ac2824226a63c6b741c88f7ae975f18b6778374", size = 5892 },
 ]
 
-[[package]]
-name = "inquirer"
-version = "3.1.4"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "blessed" },
-    { name = "python-editor" },
-    { name = "readchar" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/78/2f/6c4fd73b82228620025d0042de6dcdc8f32d87557c42ca470d965848d9b5/inquirer-3.1.4.tar.gz", hash = "sha256:958dbd5978f173630756a6ed6243acf931e750416eb7a6ed3a0ff13af0fdfcb5", size = 14626 }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/3c/b7/2b4a352659d78386e0f7f5405486aa1c41664666d33e9e8506640f702f70/inquirer-3.1.4-py3-none-any.whl", hash = "sha256:8ca28834b6c6f69e0bf19cab2e2bea2c465312bb74bd6317b88a46458163a051", size = 18215 },
-]
-
 [[package]]
 name = "instructor"
 version = "1.7.2"
@@ -2016,18 +1977,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/bd/0f/2ba5fbcd631e3e88689309dbe978c5769e883e4b84ebfe7da30b43275c5a/jinja2-3.1.5-py3-none-any.whl", hash = "sha256:aba0f4dc9ed8013c424088f68a5c226f7d6097ed89b246d7749c2ec4175c6adb", size = 134596 },
 ]
 
-[[package]]
-name = "jinxed"
-version = "1.3.0"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "ansicon", marker = "sys_platform == 'win32'" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/20/d0/59b2b80e7a52d255f9e0ad040d2e826342d05580c4b1d7d7747cfb8db731/jinxed-1.3.0.tar.gz", hash = "sha256:1593124b18a41b7a3da3b078471442e51dbad3d77b4d4f2b0c26ab6f7d660dbf", size = 80981 }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/27/e3/0e0014d6ab159d48189e92044ace13b1e1fe9aa3024ba9f4e8cf172aa7c2/jinxed-1.3.0-py2.py3-none-any.whl", hash = "sha256:b993189f39dc2d7504d802152671535b06d380b26d78070559551cbf92df4fc5", size = 33085 },
-]
-
 [[package]]
 name = "jiter"
 version = "0.8.2"
@@ -4285,15 +4234,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/6a/3e/b68c118422ec867fa7ab88444e1274aa40681c606d59ac27de5a5588f082/python_dotenv-1.0.1-py3-none-any.whl", hash = "sha256:f7b63ef50f1b690dddf550d03497b66d609393b40b564ed0d674909a68ebf16a", size = 19863 },
 ]
 
-[[package]]
-name = "python-editor"
-version = "1.0.4"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/0a/85/78f4a216d28343a67b7397c99825cff336330893f00601443f7c7b2f2234/python-editor-1.0.4.tar.gz", hash = "sha256:51fda6bcc5ddbbb7063b2af7509e43bd84bfc32a4ff71349ec7847713882327b", size = 7132 }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/c6/d3/201fc3abe391bbae6606e6f1d598c15d367033332bd54352b12f35513717/python_editor-1.0.4-py3-none-any.whl", hash = "sha256:1bf6e860a8ad52a14c3ee1252d5dc25b2030618ed80c022598f00176adc8367d", size = 4877 },
-]
-
 [[package]]
 name = "python-json-logger"
 version = "3.2.1"
@@ -4487,15 +4427,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/e3/fe/72e7e166bda3885810bee7b23049133e142f7c80c295bae02c562caeea16/pyzmq-26.2.1-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:bd8fdee945b877aa3bffc6a5a8816deb048dab0544f9df3731ecd0e54d8c84c9", size = 556563 },
 ]
 
-[[package]]
-name = "readchar"
-version = "4.2.1"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/dd/f8/8657b8cbb4ebeabfbdf991ac40eca8a1d1bd012011bd44ad1ed10f5cb494/readchar-4.2.1.tar.gz", hash = "sha256:91ce3faf07688de14d800592951e5575e9c7a3213738ed01d394dcc949b79adb", size = 9685 }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/a9/10/e4b1e0e5b6b6745c8098c275b69bc9d73e9542d5c7da4f137542b499ed44/readchar-4.2.1-py3-none-any.whl", hash = "sha256:a769305cd3994bb5fa2764aa4073452dc105a4ec39068ffe6efd3c20c60acc77", size = 9350 },
-]
-
 [[package]]
 name = "referencing"
 version = "0.36.2"

agent_starter_pack-0.0.9b0/src/cli/main.py

@@ -1,35 +0,0 @@
-# Copyright 2025 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-import click
-from rich.console import Console
-
-from src.cli.commands.create import create
-from src.cli.commands.setup_cicd import setup_cicd
-
-console = Console()
-
-
-@click.group()
-def cli() -> None:
-    """GCP Agent Starter CLI tool"""
-    pass
-
-
-# Register commands with the CLI group
-cli.add_command(create)
-cli.add_command(setup_cicd)
-
-if __name__ == "__main__":
-    cli()