Multi-Computer Lab Setup

EOS can orchestrate protocols across multiple computers using Ray for distributed communication. One computer runs the EOS orchestrator as the head node; additional computers join as worker nodes.

Main EOS Computer

1. Start Ray head node:

   eos ray head
   

2. Start EOS orchestrator:

   eos start
   

Worker Computers

1. Install dependencies:

   # Install uv
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Clone EOS repository
   git clone https://github.com/UNC-Robotics/eos
   cd eos
   
   # Create and activate virtual environment
   uv venv
   source .venv/bin/activate
   
   # Install EOS worker dependencies
   python3 scripts/install_worker.py
   
   # Or, install worker dependencies + dependencies for running EOS campaign optimizers
   python3 scripts/install_worker.py --optimizer
   

2. Connect to cluster:

   eos ray worker -a <head-node-ip>:6379