Installation Guide

​

System Requirements

​

Minimum Requirements

• OS: Ubuntu 22.04+ / macOS 12+ / Windows 10+ with WSL2
• RAM: 8GB minimum, 16GB recommended
• Storage: 20GB free space
• CPU: 4 cores minimum, 8 cores recommended
• Network: Stable internet connection for API calls

​

Software Prerequisites

• Git: Version 2.0 or higher
• Python: Version 3.11 (exactly - not 3.12+)
• Node.js: Version 18+ (for TrickyArena websites)
• Docker: Version 20.10+ (for containerized deployment)

​

Installation Methods

# Update package index
sudo apt update

# Install prerequisites
sudo apt install apt-transport-https ca-certificates curl software-properties-common

# Add Docker GPG key
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# Add Docker repository
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Install Docker
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Add user to docker group
sudo usermod -aG docker $USER
newgrp docker

# Install Docker Desktop
# Download from: https://www.docker.com/products/docker-desktop/

# Or use Homebrew
brew install --cask docker

# Start Docker Desktop from Applications

# Install WSL2 first
wsl --install

# Install Docker Desktop
# Download from: https://www.docker.com/products/docker-desktop/

# Enable WSL2 backend in Docker Desktop settings

git clone https://github.com/devinat1/agent-collector.git
cd agent-collector
git submodule update --init --recursive

cp collector/.env.example collector/.env

# OpenAI (for BrowserUse)
OPENAI_API_KEY=sk-...

# Anthropic (for Agent E)
ANTHROPIC_API_KEY=sk-ant-...

# Google (for Gemini models)
GOOGLE_API_KEY=...
GEMINI_API_KEY=...

# MultiOn
MULTION_API_KEY=...

# DoBrowser
DOBROWSER_API_KEY=...

# Skyvern
SKYVERN_API_KEY=...

# Build all agent images
docker compose build

# Or build specific agent
docker compose build browseruse

# Test with a simple prompt
mkdir -p data/prompts/test
echo -e "https://example.com\nClick the first link" > data/prompts/test/simple.txt

# Run test
docker compose up browseruse

​

Agent-Specific Setup

​

DoBrowser

• Create a DoBrowser account at dobrowser.com
• Install the Chrome extension
• Log in with Google account
• Save browser state as described above

​

Skyvern

• Requires PostgreSQL for local deployment
• Additional webhook server setup needed
• See collector/webhook_server_skyvern.py

​

WebArena/VisualWebArena

• Research agents with specific environment requirements
• May need additional model downloads
• Check respective submodule documentation

​

Troubleshooting

# Check Python version
python --version

# Use pyenv to manage versions
pyenv install 3.11.9
pyenv local 3.11.9

# Add user to docker group
sudo usermod -aG docker $USER

# Restart session or run
newgrp docker

# Install system dependencies
playwright install-deps

# Force reinstall browsers
playwright install --force

# For headless environments
playwright install chromium

# Force update submodules
git submodule update --init --recursive --force

# Or clone with submodules
git clone --recurse-submodules https://github.com/devinat1/agent-collector.git

​

Platform-Specific Notes

​

Ubuntu 24.04 LTS

• Tested and fully supported
• All installation methods work
• Recommended for production use

​

macOS (Apple Silicon)

• Use Docker Desktop with ARM64 support
• Some Python packages may need Rosetta 2
• Browser automation works natively

​

Windows

• WSL2 strongly recommended
• Native Windows support limited
• Use Docker Desktop with WSL2 backend

​

Cloud Deployment

• Works on AWS EC2, Google Cloud, Azure
• Use headless browser configurations
• Ensure sufficient resources (see requirements)

​

Next Steps