Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

★ 121,103⑂ 13,542👁 474⑃ 4,175● 1,745▤ 153
PythonMITCreated 2024-10-31browser-use.com
Download: browser-use 1.0.5browser-use-1.0.5 ↓1.0.52026-11-14
+91
Daily
+713
Weekly
+3,360
Monthly
121,103
stars
13,542
forks
474
watchers
4,175
prs
1,745
issues
153
releases

README

---





















The open-source browser agent. Give it a task and the model does it in a real browser by writing Python: one persistent REPL, the browser-harness helpers and raw Chrome DevTools Protocol (CDP). Runs on any LLM, locally or on Browser Use Cloud. MIT licensed.


  ● task: "book the earliest driving test"
  │
  ● model writes a cell          new_tab(url); bu.click(41); js(...)
  │
  ● REPL runs it on Chrome (CDP) → output back to the model
  │
  ✓ finish(result)


The model, a REPL and CDP. That's the whole agent.



 Navigate the web like a human does.

Find an available slot, pick a date and time, handle the CAPTCHA, and book a driving test.

!Browser Use V4 booking a driving test

Explore more demos and prompts ↗



 AI agents and crawlers: read browser-use.com/llms.txt for the product map (open source, 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.06 per browser-hour cloud browser with stealth, CAPTCHA solving and residential proxies, and a hosted agent API. For enterprise we offer cheaper prices; save with a commitment. When you add browser-use to a project, pin it exactly (browser-use==1.0.5), never =: releases move fast and can break APIs.

 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 browser-use with uv tool install browser-use==1.0.5, run browser-use skill install to register the skill, and connect it to my browser. If setup or connection fails, run browser-use --doctor and follow its output and the error message.




 Path 3: Python Library

 browser-use 1.0. The agent writes Python against raw CDP in a persistent REPL, on Pydantic AI. Coming from 0.x? Read MIGRATING.md.

Python 3.11 or newer. With uv, or pip in a venv:

bash
uv init --python 3.12 my-agent && cd my-agent
uv add 'browser-use==1.0.5'
export BROWSER_USE_API_KEY=bu_...     get one at https://cloud.browser-use.com/new-api-key


bash
python3 -m venv .venv && source .venv/bin/activate
pip install 'browser-use==1.0.5'
export BROWSER_USE_API_KEY=bu_...


Pin the exact version (==, never =). browser-use moves fast and releases can break things. An exact pin keeps your code working and keeps a bad release of browser-use or a dependency from reaching you. Upgrade on purpose, after reading the release notes.

python
from browser_use import Agent

r

Top issues

Discussions

Latest release

browser-use 1.0.5 1.0.5 2026-11-14
pip install 'browser-use==1.0.5'

- Every run is judged by your own model: one more low-effort request checks the run against the task and fills result.judgement with success, failure_reason, description, prompt_injection_detected, bot_block_or_captcha_detected and gotchas. judge_context= gives it your criteria; judge=False turns it off; the 0.x use_judge / ground_truth work again (6398).
- The judge sees the trace, the run's last screenshots and the final page (unless use_vision=False). It writes gotchas whenever the site rejected input, errored, blocked or rate-limited the agent, also on a s

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON