browser-use/browser-use

# Navigate the web like a human does.
Find an available slot, pick a date and time, handle the CAPTCHA, and book a driving test.
Explore more demos and prompts ↗
> AI agents and crawlers: read browser-use.com/llms.txt for the product map (open source, Browser Harness, Cloud browsers, Agents API, pricing) and docs.browser-use.com/llms.txt for the documentation index. Browser Use is the open-source browser agent (Python and TypeScript), a $0.02 per browser-hour cloud browser with stealth, CAPTCHA solving and residential proxies, and a hosted agent API.
# Which Browser Use do I need?
Path 1: Fully Hosted Cloud: Scale up with a fully hosted agent and browser.
Path 2: CLI: Automate your own browser tasks.
Path 3: Python Library: Run the open source Browser Use agent locally from your own code.
# Quickstart
## Path 1: Fully Hosted Cloud
Scale browser automation with our hosted agent, stealth browsers, and infrastructure for profiles, recordings, and data policies.
Get started with the API ↗
New Google, GitHub, or Microsoft signups get $1 cloud credit.
## Path 2: CLI
Paste this prompt into Claude Code, Codex, Hermes, OpenClaw, or your favorite agent.
text
Install or upgrade browser-use to the latest stable version with uv using Python 3.12, run browser-use skill install to register the skill, and connect it to my browser. If setup or connection fails, follow https://github.com/browser-use/browser-harness/blob/main/install.md.
## Path 3: Python Library
Run the Browser Use agent locally from Python, with your choice of model and a local or cloud browser:
1. Install Browser Use (Python >= 3.11):
With uv installed, run uv init --python 3.12 first if you're starting a new project.
bash
uv add browser-use
2. Add your OpenAI API key to .env:
bash
# .env
OPENAIAPIKEY=your-key
# BROWSERUSEAPIKEY=your-key # Optional: BU2 model or cloud browser
For either optional Browser Use service, get a Browser Use API key.
3. Save this as agent.py:
python
import asyncio
from browseruse import Agent, Browser, ChatBrowserUse, ChatOpenAI
from dotenv import loaddotenv
loaddotenv()
async def main():
llm = ChatOpenAI(model='gpt-5.6-luna', reasoningeffort='xhigh')
# llm = ChatBrowserUse(model='bu-2-0') # Use BU2 instead; requires BROWSERUSEAPIKEY
agent = Agent(
task="Find the number of stars of the browser-use repo",
llm=llm,
# browser=Browser(usecloud=True), # Use a cloud browser; requires BROWSERUSEAPIKEY
history = await agent.run()
print(history.finalresult())
if name == "main":
asyncio.run(main())
To use BU2, replace the ChatOpenAI line with the commented ChatBrowserUse line. The cloud-browser option works with either model.
4. Run it:
bash
uv run agent.py
The agent opens a browser, looks up the repository, and prints its answer.
5. Run the same agent on a cloud browser (no Chrome to install; works in Docker, CI, and serverless):
Set BROWSERUSEAPIKEY (get a key), then uncomment the browser= line in agent.py and run it again:
python
agent = Agent(
task="Find the number of stars of the browser-use repo",
llm=llm,
browser=Browser(usecloud=True),
Cloud browsers cost $0.02 per browser-hour plus network traffic (pricing), and add stealth, residential proxies, CAPTCHA solving, and a live view URL. Same code, no other changes.