Install Browser-act in two parts:
The Browser-act CLI, which performs browser automation.
The entry Skill, which tells your AI agent when and how to call the CLI.
1. Add the entry Skill
Let your agent discover Browser-act and learn that get-skills must be loaded before browser work.
2. Verify the CLI
Install browser-act-cli, check the version, and confirm the runtime can execute commands.
Agent installation
For agents that support skills, the shortest path is to ask the agent to install Browser-act for you:
Install browser-act. Skill URL: https://github.com/browser-act/skills/tree/main/browser-act After installation, verify that the CLI is available.
The agent should install the CLI, add the Skill file to its skill directory, and run a basic availability check.
Manual CLI installation
Install the CLI with uv and Python 3.12:
uv tool install browser-act-cli --python 3.12
Verify the command:
browser-act --version
Optional: API key
Note: Browser-act can run basic Chrome and chrome-direct browser automation without an API key. An API key unlocks hosted capabilities: stealth browsers, stealth-extract, dynamic proxy rotation, and solve-captcha.
Start the login flow:
browser-act auth login browser-act auth poll
Or set a key directly:
browser-act auth set <your_api_key>
Upgrade
Upgrade the CLI with:
uv tool upgrade browser-act-cli
Tip: The Skill layer can detect version mismatches between the installed Skill and the CLI. When that happens, get-skills returns upgrade guidance for the agent.
Requirements
Requirement | Notes |
Python 3.12+ | Required by the CLI package |
Chrome or Chromium | Required for |
API key | Required only for |
Troubleshooting
Command not found after installation
Warning: If browser-act is not found after installation, make sure the uv tool directory is in your shell PATH.
uv tool dir
Add the returned directory to PATH, then open a new terminal.
Send diagnostics
Upload diagnostic logs:
browser-act report-log
Send product feedback:
browser-act feedback "Describe the issue or suggestion"
What is next
Continue to Quick Start
Run a content extraction or a browser session in about a minute.
Learn the Skill System
See how the entry Skill and get-skills keep agent instructions current.
