| # 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 | |
| ```bash | |
| 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: | |
| ```bash | |
| curl -fsSL https://ollama.com/install.sh | sh | |
| # Pull the model | |
| ollama pull deepseek-r1 | |
| ``` | |
| ### C. Clone & Setup Your Workspace | |
| ```bash | |
| # 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: | |
| ```bash | |
| 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: | |
| ```bash | |
| # Run this on your LOCAL machine | |
| scp user@your-cloud-ip:~/OpenLane/designs/cloud_adder/runs/agentrun/results/final/gds/cloud_adder.gds ./ | |
| ``` | |