reasoning-deployment-service 0.3.5__py3-none-any.whl → 0.3.7__py3-none-any.whl

reasoning_deployment_service-0.3.7.dist-info/METADATA

@@ -0,0 +1,211 @@
+Metadata-Version: 2.4
+Name: reasoning-deployment-service
+Version: 0.3.7
+Summary: Deployment helper for Vertex AI Reasoning Engines & Agent Spaces
+Author-email: Sergio Estrada <sergio.estrada@accenture.com>
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/AxG-AI-Exchange-GenAI-Initiative/AIXAgentDeploymentService
+Project-URL: Repository, https://github.com/AxG-AI-Exchange-GenAI-Initiative/AIXAgentDeploymentService
+Project-URL: Issues, https://github.com/AxG-AI-Exchange-GenAI-Initiative/AIXAgentDeploymentService/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: google-auth>=2.20
+Requires-Dist: google-cloud-storage>=2.16
+Requires-Dist: google-cloud-aiplatform[adk,agent-engines]>=1.88.0
+Requires-Dist: protobuf<7.0.0,>=4.21
+Requires-Dist: keyring>=24.0
+Requires-Dist: keyrings.google-artifactregistry-auth>=1.1
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: click>=8.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# Reasoning Deployment Service
+
+Helper package for deploying Vertex AI Reasoning Engines and Agent Spaces
+
+---
+
+## 📦 Installation
+
+Install the package directly from PyPI (version 0.3.5):
+
+```bash
+pip install reasoning-deployment-service==0.3.5
+```
+
+---
+
+## 🚀 First Run
+
+Run the CLI tool with no arguments:
+
+```bash
+reasoning-deploy
+```
+
+### What happens
+
+- You will see a list of available modes:
+
+```
+Choose an operation:
+1) Create/Update
+2) Auth only
+3) CLI
+4) GUI
+q) Quit
+```
+
+- If required files are missing, usage will be limited until you bootstrap the project
+- The tool will guide you to create the starter files:
+  - `your_agent_import.py` (shim pointing to your agent folder)
+  - `.env.agent` (environment and project settings)
+  - `agent.yaml` (agent engine and space definition)
+
+Once these are in place, all modes will be fully available
+
+⚠️ Important: You must be running inside the same virtual environment where you installed reasoning-deployment-service
+
+---
+
+## ⚙️ Required Project Structure
+
+Your project must have the following at minimum:
+
+```
+my_project/
+├── requirements.txt       # pinned dependencies
+├── .env.agent             # environment and project config
+├── agent.yaml         # engine and agent space definition
+├── my_agent/              # your agent folder
+│   └── agent.py           # defines root_agent
+```
+
+---
+
+### ✅ requirements.txt
+
+This file must be in your project root and contain all dependencies
+
+Example:
+
+```text
+google-adk==1.0.0
+google-cloud-aiplatform[adk,agent_engines]>=1.88.0
+google-generativeai>=0.7.0
+pydantic>=2.0.0
+python-dotenv>=1.0.0
+python-docx>=1.1.0
+google-api-python-client>=2.100.0
+google-auth>=2.25.0
+google-auth-httplib2>=0.2.0
+google-auth-oauthlib>=1.2.0
+absl-py>=2.0.0
+PyPDF2>=3.0.0
+deprecated>=1.2.14
+reasoning-deployment-service==0.3.5
+```
+
+Install with:
+
+```bash
+pip install -r requirements.txt
+```
+
+---
+
+### ✅ my_agent/agent.py
+
+Inside your agent folder (for example `my_agent`) you must define a variable called `root_agent`
+
+Example:
+
+```python
+from google.adk.agents import LlmAgent
+
+root_agent = LlmAgent(
+    name="my_agent",
+    model="gemini-2.5-flash",
+    description="My reasoning agent",
+    instruction="You do not do a whole lot yet"
+)
+```
+
+This `root_agent` instance is what gets deployed  
+It can be an `LlmAgent`, `Agent`, or any derived class
+
+---
+
+### ✅ .env.agent
+
+Environment specific config for DEV and PROD
+
+Example:
+
+```env
+DEV_PROJECT_ID=your-dev-project-id
+DEV_PROJECT_NUMBER=123456789012
+DEV_PROJECT_LOCATION=us-central1
+DEV_STAGING_BUCKET=gs://your-dev-staging-bucket
+DEV_AGENT_SPACE_ENGINE=your-dev-agentspace-engine
+DEV_OAUTH_CLIENT_ID=your-dev-oauth-client-id.apps.googleusercontent.com
+DEV_OAUTH_CLIENT_SECRET=your-dev-oauth-client-secret
+
+PROD_PROJECT_ID=
+PROD_PROJECT_NUMBER=
+PROD_PROJECT_LOCATION=
+PROD_STAGING_BUCKET=
+PROD_AGENT_SPACE_ENGINE=
+PROD_OAUTH_CLIENT_ID=
+PROD_OAUTH_CLIENT_SECRET=
+
+REASONING_DEPLOYMENT_VERSION=0.3.5
+
+DEVELOPER=your.name
+```
+
+---
+
+### ✅ agent.yaml
+
+Example starter file:
+
+```yaml
+defaults:
+  scopes:
+    - https://www.googleapis.com/auth/cloud-platform
+    - https://www.googleapis.com/auth/userinfo.email
+  metadata:
+    reasoning_engine_name: reasoning-engine-dev
+    reasoning_engine_description: My Engine
+    agent_space_name: My Agent Space
+    agent_space_description: Example Agent Space
+    agent_space_tool_description: Example Tool
+  agent_folder: my_agent
+  auth:
+    oauth_authorization_id: test_auth
+  environment_variables:
+    - DEVELOPER
+```
+
+---
+
+## 🛠 Potential Issues
+
+- If you cannot run `reasoning-deploy`, try deleting your venv and making a new one
+- If you see a message saying you can only install on user site-packages, you will most likely need a fresh venv and new requirements install
+- Always ensure you are running `reasoning-deploy` inside the venv where it was installed
+
+---
+
+## ⚠️ Experimental Notice
+
+This tool is still experimental  
+If it takes longer than 20 to 30 minutes to set up, please go back to what already works for you and send logs and feedback to the development team

{reasoning_deployment_service-0.3.5.dist-info → reasoning_deployment_service-0.3.7.dist-info}/RECORD

@@ -1,28 +1,29 @@
 reasoning_deployment_service/__init__.py,sha256=xDuKt9gGviQiTV6vXBdkBvygnlAOIrwnUjVaMGZy0L4,670
-reasoning_deployment_service/reasoning_deployment_service.py,sha256=0QHU2IqqojwFI2wPJ0izrskiHiwBfxdBEB9I_YxYbSA,29133
-reasoning_deployment_service/runner.py,sha256=e2Uu4DdRWuCHQI4H1x8Q6s1eMbBNoWFkBTnAaspK1tk,5413
+reasoning_deployment_service/reasoning_deployment_service.py,sha256=HZLgyhwgg-MAc8mZkToTg5x9n-4eU7YrC54xZd0JYZc,38297
+reasoning_deployment_service/runner.py,sha256=HH6EfiuC77Mtkqu7CE1VbjKC-D_wL3vMCpaE1VTa32c,5493
 reasoning_deployment_service/cli_editor/__init__.py,sha256=bN8NPkw8riB92pj2lAwJZuEMOQIO_RRuge0ehnJTW1I,118
-reasoning_deployment_service/cli_editor/api_client.py,sha256=PUXPWUslFOksKMrcKjJSK_gVJkTI0bO_bqtCEYeM85g,27897
-reasoning_deployment_service/cli_editor/cli_runner.py,sha256=w8jv2ep6TiYfpc_KnlvDOJ9hsCSuZcix4Rv4GQcZO4g,15729
+reasoning_deployment_service/cli_editor/api_client.py,sha256=Kzx5iYp0MmowggrSmPLE7I2kt1-8xvdGBAgde9a1gCY,33681
+reasoning_deployment_service/cli_editor/cli_runner.py,sha256=1KkHtgAhVZ7VHQj7o76JibLHnr7NMUB-tieDX_KrAcY,18239
 reasoning_deployment_service/cli_editor/config.py,sha256=lZ8Ng007NVdN1n5spJ0OFC72TOPFWKvPRxa9eKE-FDY,3573
 reasoning_deployment_service/cli_editor/google_deps.py,sha256=PhGwdKEC96GdlFHkQrtSJrg_-w1JoUPes3zvaz22rd0,771
 reasoning_deployment_service/cli_editor/reasoning_engine_creator.py,sha256=6QC8Y9yZAT8SYNkT_R00g_SSOYuwEkIxAN9lBG3br2k,19564
 reasoning_deployment_service/gui_editor/__init__.py,sha256=e5e88iNTk1GC243DRsQFi5E7PqMaT2SXmqOez9FbYzo,128
+reasoning_deployment_service/gui_editor/agent_checkbox_list.py,sha256=ElxFqSgT3iUqDv2U9eR4eV-MfLUHqOXbDz6DqEEevOk,1783
 reasoning_deployment_service/gui_editor/main.py,sha256=4UzgGUga_xIYIWRVo-80PzhJ1Dlou8PaUXoRiLcLhp8,10914
 reasoning_deployment_service/gui_editor/src/__init__.py,sha256=q4YBECQGHtHV_TF4MyL36ElWe6tdVgmoNchN1lQU7z4,25
 reasoning_deployment_service/gui_editor/src/core/__init__.py,sha256=kH-6PxUQ-uVn79ihXN3eLyv_oFhReVsVz-f-kEK_qUo,46
-reasoning_deployment_service/gui_editor/src/core/api_client.py,sha256=rGyFKRyBY_MjRsnWxVI1IX1WAYTEfM1V5X3l1iR8GaI,26845
+reasoning_deployment_service/gui_editor/src/core/api_client.py,sha256=-AWhwKxTUM_-s5gOyTECDzEBakJSj3ik4DwXbNL4bDM,30772
 reasoning_deployment_service/gui_editor/src/core/config.py,sha256=nQT7biTArZl4zsbSZuSD_G7CU7xTJ1bZ4VPfQkxbpX4,1817
 reasoning_deployment_service/gui_editor/src/core/google_deps.py,sha256=7mMSqtvclJewEBeb-0MevZ7FE0ZEOGHyXh5V73bhpRk,495
 reasoning_deployment_service/gui_editor/src/core/reasoning_engine_creator.py,sha256=6QC8Y9yZAT8SYNkT_R00g_SSOYuwEkIxAN9lBG3br2k,19564
 reasoning_deployment_service/gui_editor/src/ui/__init__.py,sha256=262ZiXO6Luk8vZnhCIoYxOtGiny0bXK-BTKjxUNBx-w,43
-reasoning_deployment_service/gui_editor/src/ui/agent_space_view.py,sha256=TV2f0_pkw5JCQRWjVPuS-iW92toW41kPJk-pR1C0oqQ,12471
-reasoning_deployment_service/gui_editor/src/ui/authorization_view.py,sha256=uiyN411qYe7V2pnPRNdvxRkOifI-aXFI6j2De2RZp1M,10956
+reasoning_deployment_service/gui_editor/src/ui/agent_space_view.py,sha256=UTUMRFEzpUuRONl3K7bsCPRjZ_hiVE1s9fTsIHTZtSs,17130
+reasoning_deployment_service/gui_editor/src/ui/authorization_view.py,sha256=BoNcGRFZ-Rb2pnOAAZxraP7yDdbwMJNvIrBrjMc_hbw,16970
 reasoning_deployment_service/gui_editor/src/ui/reasoning_engine_view.py,sha256=tCvSPEf4dW0NRdAqfs3yT5Pa873gYeLzCMMIt2r2T4o,14644
 reasoning_deployment_service/gui_editor/src/ui/reasoning_engines_view.py,sha256=IRjFlBbY98usAZa0roOonjvWQOsF6NBW4bBg_k8KnKI,7860
 reasoning_deployment_service/gui_editor/src/ui/ui_components.py,sha256=HdQHy-oSZ3GobQ3FNdH7y_w3ANbFiuf2rMoflAmff0A,55366
-reasoning_deployment_service-0.3.5.dist-info/METADATA,sha256=t6j6T_kXXQuzStSR53_2h1WUfB_wDyvxOLT27Gmpr6s,4991
-reasoning_deployment_service-0.3.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-reasoning_deployment_service-0.3.5.dist-info/entry_points.txt,sha256=onGKjR5ONTtRv3aqEtK863iw9Ty1kLcjfZlsplkRZrA,84
-reasoning_deployment_service-0.3.5.dist-info/top_level.txt,sha256=GKuQS1xHUYLZbatw9DmcYdBxxLhWhhGkV4FmFxgKdp0,29
-reasoning_deployment_service-0.3.5.dist-info/RECORD,,
+reasoning_deployment_service-0.3.7.dist-info/METADATA,sha256=O64D_CXQKcexIEf1V84DYWa67XaFKTQ6kDwYxA6U4sw,5302
+reasoning_deployment_service-0.3.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+reasoning_deployment_service-0.3.7.dist-info/entry_points.txt,sha256=onGKjR5ONTtRv3aqEtK863iw9Ty1kLcjfZlsplkRZrA,84
+reasoning_deployment_service-0.3.7.dist-info/top_level.txt,sha256=GKuQS1xHUYLZbatw9DmcYdBxxLhWhhGkV4FmFxgKdp0,29
+reasoning_deployment_service-0.3.7.dist-info/RECORD,,

reasoning_deployment_service-0.3.5.dist-info/METADATA

@@ -1,183 +0,0 @@
-Metadata-Version: 2.4
-Name: reasoning-deployment-service
-Version: 0.3.5
-Summary: Deployment helper for Vertex AI Reasoning Engines & Agent Spaces
-Author-email: Sergio Estrada <sergio.estrada@accenture.com>
-License: Apache-2.0
-Project-URL: Homepage, https://github.com/AxG-AI-Exchange-GenAI-Initiative/AIXAgentDeploymentService
-Project-URL: Repository, https://github.com/AxG-AI-Exchange-GenAI-Initiative/AIXAgentDeploymentService
-Project-URL: Issues, https://github.com/AxG-AI-Exchange-GenAI-Initiative/AIXAgentDeploymentService/issues
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: requests>=2.28
-Requires-Dist: python-dotenv>=1.0
-Requires-Dist: google-auth>=2.20
-Requires-Dist: google-cloud-storage>=2.16
-Requires-Dist: google-cloud-aiplatform[adk,agent-engines]>=1.88.0
-Requires-Dist: protobuf<7.0.0,>=4.21
-Requires-Dist: keyring>=24.0
-Requires-Dist: keyrings.google-artifactregistry-auth>=1.1
-Requires-Dist: PyYAML>=6.0
-Requires-Dist: click>=8.0
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: build; extra == "dev"
-Requires-Dist: twine; extra == "dev"
-Requires-Dist: black; extra == "dev"
-Requires-Dist: ruff; extra == "dev"
-
-# Reasoning Deployment Service
-
-A comprehensive service for deploying reasoning agents with CLI and GUI editors.
-
-## Installation
-
-### Basic Installation (Core deployment service only)
-
-```bash
-pip install reasoning-deployment-service
-```
-
-### Installation with GUI Editor
-
-```bash
-pip install "reasoning-deployment-service[gui]"
-```
-
-### Installation with CLI Editor
-
-```bash
-pip install "reasoning-deployment-service[cli]"
-```
-
-### Full Installation (Everything)
-
-```bash
-pip install "reasoning-deployment-service[full]"
-```
-
-## Quick Start
-
-### Using the Deploy Script (Recommended)
-
-The easiest way to get started is using the provided deploy script:
-
-```bash
-# Download and run the deploy script
-curl -O https://raw.githubusercontent.com/your-org/AIXAgentDeploymentService/main/deploy.sh
-chmod +x deploy.sh
-./deploy.sh
-```
-
-The deploy script will:
-
-- Set up a virtual environment
-- Install all necessary dependencies
-- Create a `deploy.py` file configured for your agent
-- Run the deployment
-
-## Manual Usage
-
-### Core Deployment Service
-
-The main deployment service for reasoning engines:
-
-```python
-from reasoning_deployment_service import ReasoningEngineDeploymentService
-from google.adk.agents import BaseAgent
-
-# Your agent implementation
-class MyAgent(BaseAgent):
-    # ... your agent implementation
-
-# Deploy using the service
-agent = MyAgent()
-deployment_service = ReasoningEngineDeploymentService(
-    root_agent=agent,
-    deployment_environment="DEV"  # or "PROD"
-)
-
-# Deploy everything
-deployment_service.one_deployment_with_everything_on_it()
-```
-
-### CLI Editor (Optional)
-
-For command-line management of reasoning engines and agent spaces:
-
-```python
-from reasoning_deployment_service.cli_editor import CLIRunner
-
-# Start the CLI interface
-cli = CLIRunner()
-cli.run()
-```
-
-### GUI Editor (Optional)
-
-For graphical management interface:
-
-```python
-from reasoning_deployment_service.gui_editor import GUIEditor
-
-# Start the GUI application
-app = GUIEditor()
-app.mainloop()
-```
-
-## Configuration
-
-Create a `.env` file with your deployment environment variables:
-
-```bash
-# Development Profile
-DEV_PROJECT_ID=your-project-id
-DEV_PROJECT_NUMBER=your-project-number
-DEV_PROJECT_LOCATION=us-central1
-DEV_STAGING_BUCKET=gs://your-staging-bucket
-DEV_AGENT_SPACE_ENGINE=your-agent-space-engine
-DEV_OAUTH_CLIENT_ID=your-oauth-client-id
-DEV_OAUTH_CLIENT_SECRET=your-oauth-client-secret
-
-# Production Profile
-PROD_PROJECT_ID=your-prod-project-id
-PROD_PROJECT_NUMBER=your-prod-project-number
-# ... etc
-```
-
-Create an `aix_agent.yaml` file with your agent metadata:
-
-```yaml
-defaults:
-  scopes:
-    - "https://www.googleapis.com/auth/cloud-platform"
-  metadata:
-    reasoning_engine_name: "my-reasoning-engine"
-    reasoning_engine_description: "My custom reasoning engine"
-    agent_space_name: "my-agent-space"
-    agent_space_description: "My agent space"
-    agent_space_tool_description: "Tool description"
-  auth:
-    oauth_authorization_id: "my-auth-id"
-  environment_variables:
-    - "CUSTOM_VAR=value"
-```
-
-## Dependency Management
-
-Dependencies are now centrally managed in `setup.py`:
-
-- **Core dependencies**: Installed automatically with the base package
-- **GUI dependencies**: Install with `[gui]` extra for tkinter-based interface
-- **CLI dependencies**: Install with `[cli]` extra (currently no additional deps)
-- **Full dependencies**: Install with `[full]` extra for complete functionality
-
-## Modular Usage
-
-Each component can be used independently:
-
-- **Core Service**: Just use `ReasoningEngineDeploymentService` for programmatic deployment
-- **CLI Editor**: Add `cli_editor` for command-line management
-- **GUI Editor**: Add `gui_editor` for graphical interface
-
-The package is designed so users can import only what they need and instantiate the components they want to use.