Iris Agent

An AI-powered browser agent that combines Playwright, Chrome, and LLMs to help you automate web tasks.

Quick Install

Get up and running in seconds with our one-line installer:

curl -fsSL https://tinyurl.com/tryiris | bash

This will install Docker if needed, pull the Iris Agent image, and start the service.

Available Services

Service	Port	Description
API Server	3000	Main API endpoint for interacting with Iris Agent
VNC Server	5901	Direct VNC access to view the browser in action
noVNC Web Interface	6901	Browser-based VNC client for viewing browser activity

Configuration

Environment Variables

Variable	Default	Description
`WIDTH`, `HEIGHT`	1024x768	Set the VNC resolution
`OPENAI_API_KEY`	-	Your OpenAI API key for LLM integration
`ANTHROPIC_API_KEY`	-	Your Anthropic API key (optional)
`PORT`	3000	API server port
`LOG_LEVEL`	debug	Logging verbosity level
`RABBITMQ_*` variables	varies	RabbitMQ connection settings

Custom Configuration

Create a custom configuration file to override defaults:

# Create custom config file
cat > iris-config.env << EOL
WIDTH=1920
HEIGHT=1080
OPENAI_API_KEY=your_api_key_here
PORT=8080
EOL

# Use custom config when launching
curl -fsSL https://tinyurl.com/tryiris | bash -s -- --env-file iris-config.env

Manual Installation

If you prefer to set up manually with Docker Compose:


    version: '3'
    services:
    chrome-desktop-playwright:
        image: shanurcsenitap/chrome-desktop-playwright
        container_name: chrome-desktop-playwright
        hostname: chrome-desktop-playwright
        ports:
        - "3000:3000"   # Internal service port
        - "5901:5901"   # VNC port
        - "6901:6901"   # noVNC port
        environment:
        - VNC_RESOLUTION=1024x768
        - PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/chromium
        - LOG_LEVEL=debug
        - RABBITMQ_QUEUE=browser_tasks
        - OPENAI_API_KEY=your_api_key_here
        - PORT=3000
        - RABBITMQ_USER=admin
        - RABBITMQ_PASSWORD=admin
        - RABBITMQ_HOST=rabbitmq
        - RABBITMQ_PORT=5672

docker-compose up -d