a11y-for-agents

Install

This project includes uv.lock, so install dependencies from the lock file:

uv sync --locked

If you do not have uv installed yet:

curl -LsSf https://astral.sh/uv/install.sh | sh

Install the browser runtime if Chromium is not available:

uvx browser-use install

Setup API key

Create .env:

OPENAI_API_KEY=your openai api key

Run search a11yvillage demo

Run with browser_use:

uv run python search_a11y_village/run_bu.py

This writes the markdown result to search_a11y_village/result_bu.md.

Run with Playwright:

uv run python search_a11y_village/run_pw.py

This writes the markdown result to search_a11y_village/result_pw.md.

Notes

See notes.md for the demo task flow and notes about how semantics help Browser Use, Playwright, and agents operate the site.