Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.browseract.com/llms.txt

Use this file to discover all available pages before exploring further.

Install Browser-act in two parts:
  1. The Browser-act CLI, which performs browser automation.
  2. 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

RequirementNotes
Python 3.12+Required by the CLI package
Chrome or ChromiumRequired for chrome and chrome-direct browser types
API keyRequired only for stealth browser features

​
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.