Skip to main content
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:
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:
Verify the command:

​
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:
Or set a key directly:

​
Upgrade

Upgrade the CLI with:
[!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

​
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.
Add the returned directory to PATH, then open a new terminal.

​
Send diagnostics

Upload diagnostic logs:
Send product feedback:

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