Installation¶

Go Install¶

The easiest way to install agent-a11y:

go install github.com/plexusone/agent-a11y/cmd/agent-a11y@latest

From Source¶

git clone https://github.com/plexusone/agent-a11y.git
cd agent-a11y
go build -o agent-a11y ./cmd/agent-a11y

Prerequisites¶

Go Version¶

agent-a11y requires Go 1.25 or later.

Browser¶

For browser-based testing, you need Chrome or Chromium installed. agent-a11y uses the Vibium browser automation library which manages browser instances.

The browser is discovered in this order:

VIBIUM_CLICKER_PATH environment variable
System PATH
Default installation locations

LLM API Keys (Optional)¶

For LLM-enhanced evaluation, set the appropriate API key:

# Anthropic
export ANTHROPIC_API_KEY="your-key"

# OpenAI
export OPENAI_API_KEY="your-key"

# Google
export GOOGLE_API_KEY="your-key"

# xAI
export XAI_API_KEY="your-key"

Verify Installation¶

agent-a11y version

Expected output:

agent-a11y v0.1.0 (commit: abc1234, built: 2026-02-28)

Go Library¶

To use agent-a11y as a Go library:

go get github.com/plexusone/agent-a11y@latest

Then import:

import a11y "github.com/plexusone/agent-a11y"