feat: GCP multi-cloud deployment with 100-agent configurations

.gitignore

@@ -53,6 +53,8 @@ test_logs/
 *.swp
 *.swo
 *~
+AGENTS.md
+.github/
 
 # macOS
 .DS_Store

README.md

@@ -15,7 +15,22 @@ A production-ready framework for deploying and managing specialized AI agents wi
 
 ## Quick Start
 
-### Deploy a Single Agent
+### Deploy on AWS
+
+```bash
+# Single agent deployment
+bash scripts/aws/single-agent-deployment.sh \
+  "agent-id" "anthropic-api-key" "Agent Name" "domain" \
+  "specialization" "description" "capabilities" "smithery-api-key" \
+  "registry-url" "mcp-registry-url" "port" "region" "instance-type"
+
+# Multi-agent deployment
+bash scripts/aws/multi-agent-deployment.sh \
+  "anthropic-api-key" "agent-config-json" "smithery-api-key" \
+  "registry-url" "mcp-registry-url" "region" "instance-type"
+```
+
+### Deploy on Google Cloud Platform (GCP)
 
 ```bash
 bash scripts/aws-single-agent-deployment.sh \
@@ -34,14 +49,12 @@ bash scripts/aws-single-agent-deployment.sh \
   "instance-type"                 # EC2 instance type 
 ```
 
-**Example:**
+**Example (AWS):**
+
 ```bash
-bash scripts/aws-single-agent-deployment.sh \
-  "furniture-expert" \
-  "sk-ant-api03-..." \
-  "Furniture Expert" \
-  "furniture and interior design" \
-  "knowledgeable furniture specialist" \
+bash scripts/aws/single-agent-deployment.sh \
+  "furniture-expert" "sk-ant-api03-..." "Furniture Expert" \
+  "furniture and interior design" "knowledgeable furniture specialist" \
   "I help with furniture selection and interior design" \
   "furniture,interior design,decor" \
   "smithery-key-xxxxx" \
@@ -52,7 +65,7 @@ bash scripts/aws-single-agent-deployment.sh \
   "t3.micro"
 ```
 
-### Deploy Multiple Agents (10 per instance)
+**Example (GCP):**
 
 ```bash
 bash scripts/aws-multi-agent-deployment.sh \
@@ -67,7 +80,7 @@ bash scripts/aws-multi-agent-deployment.sh \
 
 ## Architecture
 
-```
+```text
 NEST/
 ├── nanda_core/                        # Core framework
 │   ├── core/
@@ -176,6 +189,7 @@ Pre-configured agent groups for quick deployment:
 ## Monitoring
 
 Each deployed agent includes:
+
 - **Health checks** on startup
 - **Automatic registry registration**
 - **Process management** with supervisor
@@ -196,6 +210,7 @@ Each deployed agent includes:
 ### Agent Personality Configuration
 
 Agents are configured with:
+
 - **Domain**: Primary area of expertise
 - **Specialization**: Specific role and personality
 - **Description**: Detailed background for system prompt
@@ -204,13 +219,15 @@ Agents are configured with:
 ## Testing
 
 ### Test Single Agent
+
 ```bash
 curl -X POST http://agent-ip:{PORT}/a2a \
   -H "Content-Type: application/json" \
   -d '{"content":{"text":"Hello! What can you help me with?","type":"text"},"role":"user","conversation_id":"test123"}'
 ```
 
 ### Test A2A Communication
+
 ```bash
 curl -X POST http://agent-a-ip:{PORT}/a2a \
   -H "Content-Type: application/json" \
@@ -242,11 +259,12 @@ MIT License - see LICENSE file for details.
 ## Support
 
 For issues and questions:
+
 - Create an issue in this repository
 - Check the documentation in `/scripts/README.md`
 - Review example configurations in `/scripts/`
 
 ---
 
 **Built by Project NANDA**  
-[Visit Project NANDA](https://github.com/projnanda) | [NEST Repository](https://github.com/projnanda/NEST)
+[Visit Project NANDA](https://github.com/projnanda) | [NEST Repository](https://github.com/projnanda/NEST)

scripts/README.md

@@ -1,22 +1,51 @@
 # 🚀 NANDA Agent Deployment Scripts
 
-Production-ready scripts for deploying NANDA agents to AWS EC2.
+Production-ready scripts for deploying NANDA agents across multiple cloud platforms.
 
-## 📋 Available Scripts
+## ☁️ Multi-Cloud Support
 
-### 🤖 Single Agent Deployment
-**`aws-single-agent-deployment.sh`** - Deploy one specialized agent to one EC2 instance
+Deploy NANDA agents on your preferred cloud provider:
 
+| Platform | Directory | Status | Documentation |
+|----------|-----------|--------|---------------|
+| **AWS** | `aws/` | ✅ Production Ready | [AWS README](aws/README.md) |
+| **GCP** | `gcp/` | ✅ Production Ready | [GCP README](gcp/README.md) |
+| **Azure** | `azure/` | ✅ Production Ready | [Azure README](azure/README.md) |
+
+Each platform supports:
+- 🤖 **Single Agent Deployment** - One agent per VM/instance
+- 🏭 **Multi-Agent Deployment** - Multiple agents on one VM (supervisor-managed)
+- 🌍 **Multi-Region Deployment** - Deploy across multiple regions
+
+---
+
+## Quick Start
+
+### AWS Deployment
+```bash
+cd aws
+bash single-agent-deployment.sh "agent-id" "sk-ant-..." "Agent Name"
+```
+
+### GCP Deployment
+```bash
+cd gcp
+bash single-agent-deployment.sh "agent-id" "sk-ant-..." "Agent Name"
+```
+
+### Azure Deployment
 ```bash
 bash aws-single-agent-deployment.sh <AGENT_ID> <API_KEY> <NAME> <DOMAIN> <SPECIALIZATION> <DESCRIPTION> <CAPABILITIES> [SMITHERY_API_KEY] [REGISTRY_URL] [MCP_REGISTRY_URL] [PORT] [REGION] [INSTANCE_TYPE]
 ```
 
 **Example:**
 ```bash
-bash aws-single-agent-deployment.sh \
+cd aws
+bash single-agent-deployment.sh \
   "data-scientist" \
   "sk-ant-api03-..." \
   "Data Scientist" \
+  "main" \
   "data analysis" \
   "expert data analyst and machine learning specialist" \
   "I help with statistical analysis, machine learning, and data visualization" \
@@ -30,15 +59,28 @@ bash aws-single-agent-deployment.sh \
 ```
 
 ### 🏭 Multi-Agent Deployment  
-**`aws-multi-agent-deployment.sh`** - Deploy 10 agents to one EC2 instance
+Deploy multiple agents (typically 10) to one VM/instance with supervisor management
+
+**Example (AWS):**
+```bash
+cd aws
+bash multi-agent-deployment.sh \
+  "sk-ant-api03-..." \
+  "../agent_configs/group-01-business-and-finance-experts.json" \
+  "http://registry.chat39.com:6900" \
+  "us-east-1" \
+  "t3.large"
+```
 
+**Example (GCP):**
 ```bash
 bash aws-multi-agent-deployment.sh <API_KEY> <CONFIG_JSON> [SMITHERY_API_KEY] [REGISTRY_URL] [MCP_REGISTRY_URL] [REGION] [INSTANCE_TYPE]
 ```
 
-**Example:**
+**Example (Azure):**
 ```bash
-bash aws-multi-agent-deployment.sh \
+cd azure
+bash multi-agent-deployment.sh \
   "sk-ant-api03-..." \
   "agent_configs/group-01-business-and-finance-experts.json" \
   "smithery-key-xxxxx" \
@@ -48,14 +90,26 @@ bash aws-multi-agent-deployment.sh \
   "t3.xlarge"
 ```
 
-### 🖥️ Existing Server Deployment
-**`deploy-agent.sh`** - Deploy agent to existing Ubuntu/Amazon Linux server
+### 🌍 Multi-Region Deployment
+Deploy agent groups across multiple regions for geographic distribution
 
+**Example (GCP):**
 ```bash
-bash deploy-agent.sh <AGENT_TYPE> <AGENT_ID> <API_KEY> [PORT] [REGISTRY_URL]
+cd gcp
+bash multi-region-deployment.sh \
+  "sk-ant-api03-..." \
+  '[{"region":"us-central1-a","config":"../agent_configs/group-01.json"},{"region":"us-west1-b","config":"../agent_configs/group-02.json"}]'
+```
+
+**Example (Azure):**
+```bash
+cd azure
+bash multi-region-deployment.sh \
+  "sk-ant-api03-..." \
+  '[{"region":"eastus","config":"../agent_configs/group-01.json"},{"region":"westus","config":"../agent_configs/group-02.json"}]'
 ```
 
-## 📦 Pre-configured Agent Groups
+---
 
 Ready-to-deploy agent configurations: