reasoning-deployment-service 0.2.8__tar.gz

reasoning_deployment_service-0.2.8/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: reasoning-deployment-service
+Version: 0.2.8
+Summary: Deployment helper for Vertex AI Reasoning Engines & Agent Spaces
+Author: AxG-AI-Exchange-GenAI-Initiative
+Author-email: Sergio Estrada <sergio.estrada@accenture.com>
+License: Apache-2.0
+Requires-Python: >=3.7
+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: keyring>=24.0
+Requires-Dist: keyrings.google-artifactregistry-auth>=1.1
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: author
+Dynamic: requires-python
+
+# 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.

reasoning_deployment_service-0.2.8/README.md

@@ -0,0 +1,155 @@
+# 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.

reasoning_deployment_service-0.2.8/examples/programmatic_usage.py

@@ -0,0 +1,154 @@
+#!/usr/bin/env python3
+"""
+Example: Programmatic usage of reasoning deployment service components
+"""
+
+import os
+import threading
+import time
+
+def example_cli_usage():
+    """Example of starting CLI editor programmatically."""
+    print("📋 CLI Editor Example:")
+    print("-" * 30)
+    
+    try:
+        from reasoning_deployment_service.cli_editor import CLIRunner
+        
+        # Create CLI runner
+        cli = CLIRunner()
+        
+        # Note: cli.run() is interactive and will block
+        # For demo purposes, we'll just show it's available
+        print("✅ CLI Runner created successfully")
+        print("💡 To run: cli.run()")
+        print("🔄 This will start an interactive CLI session")
+        
+        return cli
+        
+    except Exception as e:
+        print(f"❌ Error with CLI: {e}")
+        return None
+
+def example_gui_usage():
+    """Example of starting GUI editor programmatically.""" 
+    print("\n🖼️ GUI Editor Example:")
+    print("-" * 30)
+    
+    try:
+        from reasoning_deployment_service.gui_editor import GUIEditor
+        
+        # Note: We don't actually create the GUI to avoid issues in headless environments
+        print("✅ GUI Editor class available")
+        print("💡 To run: app = GUIEditor(); app.mainloop()")
+        print("🔄 This will start the tkinter GUI application")
+        
+        return GUIEditor
+        
+    except Exception as e:
+        print(f"❌ Error with GUI: {e}")
+        return None
+
+def example_core_deployment():
+    """Example of using core deployment service."""
+    print("\n⚙️ Core Deployment Service Example:")
+    print("-" * 40)
+    
+    try:
+        from reasoning_deployment_service import ReasoningEngineDeploymentService
+        
+        print("✅ Core deployment service available")
+        print("💡 Usage:")
+        print("   service = ReasoningEngineDeploymentService(agent, 'DEV')")
+        print("   service.one_deployment_with_everything_on_it()")
+        
+        return ReasoningEngineDeploymentService
+        
+    except Exception as e:
+        print(f"❌ Error with core service: {e}")
+        return None
+
+def example_integrated_workflow():
+    """Example of an integrated workflow."""
+    print("\n🔗 Integrated Workflow Example:")
+    print("-" * 35)
+    
+    print("""
+def integrated_agent_workflow():
+    # 1. Deploy your agent
+    from reasoning_deployment_service import ReasoningEngineDeploymentService
+    from google.adk.agents import BaseAgent
+    
+    class MyAgent(BaseAgent):
+        def invoke(self, input_text: str) -> str:
+            return f"Agent response: {input_text}"
+    
+    agent = MyAgent()
+    service = ReasoningEngineDeploymentService(agent, "DEV")
+    service.one_deployment_with_everything_on_it()
+    
+    # 2. Launch management interface
+    choice = input("Choose interface (cli/gui): ")
+    
+    if choice == "cli":
+        from reasoning_deployment_service.cli_editor import CLIRunner
+        cli = CLIRunner()
+        cli.run()
+    elif choice == "gui":
+        from reasoning_deployment_service.gui_editor import GUIEditor
+        app = GUIEditor()
+        app.mainloop()
+""")
+
+def check_environment():
+    """Check if environment is properly configured."""
+    print("\n🔍 Environment Check:")
+    print("-" * 20)
+    
+    required_vars = [
+        "DEV_PROJECT_ID", "DEV_PROJECT_NUMBER", 
+        "DEV_PROJECT_LOCATION", "DEV_STAGING_BUCKET"
+    ]
+    
+    missing = []
+    for var in required_vars:
+        if not os.getenv(var):
+            missing.append(var)
+    
+    if missing:
+        print(f"⚠️ Missing environment variables: {missing}")
+        print("💡 Set these in your .env file before using the services")
+        return False
+    else:
+        print("✅ Environment variables look good!")
+        return True
+
+def main():
+    """Main example function."""
+    print("🚀 Reasoning Deployment Service - Programmatic Usage Examples")
+    print("=" * 65)
+    
+    # Check environment
+    env_ok = check_environment()
+    
+    # Show component examples
+    cli = example_cli_usage()
+    gui_class = example_gui_usage() 
+    core = example_core_deployment()
+    example_integrated_workflow()
+    
+    # Summary
+    print("\n📝 Summary:")
+    print("-" * 12)
+    print(f"✅ CLI Editor: {'Available' if cli else 'Not available'}")
+    print(f"✅ GUI Editor: {'Available' if gui_class else 'Not available'}")
+    print(f"✅ Core Service: {'Available' if core else 'Not available'}")
+    print(f"✅ Environment: {'Configured' if env_ok else 'Needs setup'}")
+    
+    if cli and gui_class and core:
+        print("\n🎉 All components are ready for programmatic use!")
+    else:
+        print("\n⚠️ Some components may need additional setup or dependencies.")
+
+if __name__ == "__main__":
+    main()

reasoning_deployment_service-0.2.8/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "reasoning-deployment-service"
+version = "0.2.8"
+description = "Deployment helper for Vertex AI Reasoning Engines & Agent Spaces"
+readme = "README.md"
+license = { text = "Apache-2.0" }
+requires-python = ">=3.9"
+
+authors = [
+  { name = "Sergio Estrada", email = "sergio.estrada@accenture.com" }
+]
+
+dependencies = [
+  "requests>=2.28",
+  "python-dotenv>=1.0",
+  "google-auth>=2.20",
+  "google-cloud-storage>=2.16",
+  "keyring>=24.0",
+  "keyrings.google-artifactregistry-auth>=1.1"
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest",
+  "build",
+  "twine",
+]
+
+[project.urls]
+
+[tool.setuptools.packages.find]
+where = ["."]

reasoning_deployment_service-0.2.8/reasoning_deployment_service/__init__.py

@@ -0,0 +1,25 @@
+# Initialize the reasoning_deployment_service package
+
+from .reasoning_deployment_service import ReasoningEngineDeploymentService
+
+# Import submodules for optional use
+try:
+    from . import cli_editor
+    from . import gui_editor
+    CLI_AVAILABLE = True
+    GUI_AVAILABLE = True
+except ImportError as e:
+    print(f"Warning: Some optional components not available: {e}")
+    CLI_AVAILABLE = False
+    GUI_AVAILABLE = False
+
+# Make main classes available for direct import
+__all__ = [
+    'ReasoningEngineDeploymentService',
+]
+
+# Add optional components if available
+if CLI_AVAILABLE:
+    __all__.append('cli_editor')
+if GUI_AVAILABLE:
+    __all__.append('gui_editor')

reasoning_deployment_service-0.2.8/reasoning_deployment_service/cli_editor/__init__.py

@@ -0,0 +1,5 @@
+"""CLI Editor module for reasoning deployment service."""
+
+from .cli_runner import CLIRunner
+
+__all__ = ['CLIRunner']