docs/CLOUD_DEPLOY.md

Cloud Migration Guide for AgentIC + OpenLane

This guide explains how to move your local AI-to-GDSII flow to a cloud provider (AWS, GCP, Azure, Lambda Labs, or RunPod).

1. Hardware Requirements

OpenLane and Local LLMs are resource-intensive. Do not use a "Free Tier" (t2.micro) instance.

• CPU: 4 vCPUs minimum (8 recommended for Place & Route).
• RAM: 16 GB minimum (32 GB recommended).
• Storage: 50 GB SSD minimum (Docker images + PDKs take ~30GB).
• GPU: NVIDIA T4 (16GB VRAM) or better recommended if running Ollama locally.

2. Setup Script (Ubuntu 22.04 / 24.04)

Run these commands on your new cloud instance to replicate your environment.

A. Install System Dependencies

sudo apt-get update && sudo apt-get install -y \
    docker.io \
    python3-pip \
    python3-venv \
    git \
    make \
    curl \
    iverilog
    
# Add user to docker group (avoids sudo for docker)
sudo usermod -aG docker $USER
newgrp docker

B. Install Ollama (for DeepSeek)

If you have a GPU, install the Nvidia Container Toolkit first. If CPU-only, just run:

curl -fsSL https://ollama.com/install.sh | sh

# Pull the model
ollama pull deepseek-r1

C. Clone & Setup Your Workspace

# Clone OpenLane (Infrastructure)
git clone https://github.com/The-OpenROAD-Project/OpenLane.git ~/OpenLane
cd ~/OpenLane
make pull-openlane  # Downloads the heavy Docker images

# Clone AgentIC (Your Logic)
# (Assuming you push your local code to a git repo first)
git clone <YOUR_GITHUB_REPO_URL> ~/AgentIC

# Setup Python Env
cd ~/AgentIC
python3 -m venv agentic_env
source agentic_env/bin/activate
pip install -r requirements.txt

3. Remote Access

To view your designs (GDSII files) or access the terminal easily, use VS Code Remote - SSH.

1. In local VS Code: Install "Remote - SSH" extension.
2. Connect to ssh user@your-cloud-ip.
3. Open the folder /home/user/AgentIC.

4. Modified Flow for Cloud (Headless)

Since you won't have a GUI window for klayout or unnecessary graphics:

1. Run the build command normally:

   python main.py build --name cloud_adder --desc "8-bit adder"
   

2. Viewing Results: Do not try to open KLayout on the server. Instead, use the scp command to copy the final GDS file to your local machine:

   # Run this on your LOCAL machine
   scp user@your-cloud-ip:~/OpenLane/designs/cloud_adder/runs/agentrun/results/final/gds/cloud_adder.gds ./