browser-use/browser-usePublic

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

AI summary: An open-source library that empowers autonomous AI agents to interact directly with web browsers natively.

Stars
120.8K
+17 today
Forks
13.5K
Watchers
473
Open issues
183
Open PRs
434
Contributors
~385
Commits
11K
Branches
645
Views (30d)
8

PythonMITCreated Oct 31, 2024Last push todayLatest release 1.0.2+624 stars this week+2.9K this month

Quick answers

What is browser-use?
An open-source library that empowers autonomous AI agents to interact directly with web browsers natively.
What does browser-use do?
This library provides a robust framework bridging large language models with actual web browser instances seamlessly. It allows AI agents to navigate web pages, click elements, extract data, and fill forms dynamically. The system operates by translating high-level natural language intents into concrete Playwright automation commands instantly. It supports various language models including GPT-4 and Claude to drive the underlying navigation logic. Developers can integrate custom functions easily, extending the agent's capabilities to interact with complex web applications.
Who is browser-use for?
AI engineers and software developers aiming to build autonomous agents capable of interacting with the real-world web. Researchers experimenting with large language models and practical task completion scenarios.
How do I get started with browser-use?
pip install browser-use
How popular is browser-use on GitHub?
browser-use/browser-use has 120,756 stars and 13,497 forks on GitHub, and gained 624 stars in the last 7 days.
What license does browser-use use?
browser-use/browser-use is released under the MIT license.

Star history

since Jul 28, 2026
050K100KJul 2026Sep 2026Oct 2026Nov 2026
120.8K stars as of Nov 12, 2026. Measured daily since Jul 28, 2026; GitHub no longer exposes earlier star timestamps.

Update history

5 recorded
  • Nov 11, 2026New release 1.0.2 (previously 0.13.14).
  • Nov 3, 2026New release 0.13.14 (previously 0.13.13).
  • Oct 17, 2026New release 0.13.13 (previously 0.13.11).
  • Oct 15, 2026Description changed from "Agents that use the browser." to "Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.".
  • Oct 9, 2026New release 0.13.11 (previously 0.13.10).

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-16: 5 commits2025-11-17: 8 commits2025-11-18: 31 commits2025-11-19: 5 commits2025-11-20: 22 commits2025-11-21: 14 commits2025-11-22: 22 commits2025-11-23: 5 commits2025-11-24: 14 commits2025-11-25: 6 commits2025-11-26: 37 commits2025-11-27: 6 commits2025-11-28: 9 commits2025-11-29: 21 commits2025-11-30: 2 commits2025-12-01: 2 commits2025-12-02: 4 commits2025-12-03: 11 commits2025-12-04: 2 commits2025-12-05: 2 commits2025-12-06: 1 commit2025-12-07: 2 commits2025-12-08: 4 commits2025-12-09: 16 commits2025-12-10: 9 commits2025-12-11: 2 commits2025-12-12: 9 commits2025-12-13: 1 commit2025-12-14: 9 commits2025-12-15: 7 commits2025-12-16: 12 commits2025-12-17: 11 commits2025-12-18: 8 commits2025-12-19: 5 commits2025-12-20: 0 commits2025-12-21: 4 commits2025-12-22: 5 commits2025-12-23: 13 commits2025-12-24: 0 commits2025-12-25: 4 commits2025-12-26: 1 commit2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 2 commits2026-01-04: 0 commits2026-01-05: 4 commits2026-01-06: 2 commits2026-01-07: 2 commits2026-01-08: 3 commits2026-01-09: 0 commits2026-01-10: 9 commits2026-01-11: 2 commits2026-01-12: 1 commit2026-01-13: 0 commits2026-01-14: 1 commit2026-01-15: 10 commits2026-01-16: 7 commits2026-01-17: 0 commits2026-01-18: 2 commits2026-01-19: 5 commits2026-01-20: 0 commits2026-01-21: 8 commits2026-01-22: 2 commits2026-01-23: 22 commits2026-01-24: 6 commits2026-01-25: 18 commits2026-01-26: 12 commits2026-01-27: 16 commits2026-01-28: 6 commits2026-01-29: 15 commits2026-01-30: 29 commits2026-01-31: 48 commits2026-02-01: 6 commits2026-02-02: 39 commits2026-02-03: 17 commits2026-02-04: 11 commits2026-02-05: 14 commits2026-02-06: 1 commit2026-02-07: 0 commits2026-02-08: 16 commits2026-02-09: 33 commits2026-02-10: 57 commits2026-02-11: 32 commits2026-02-12: 29 commits2026-02-13: 0 commits2026-02-14: 1 commit2026-02-15: 3 commits2026-02-16: 6 commits2026-02-17: 14 commits2026-02-18: 10 commits2026-02-19: 13 commits2026-02-20: 8 commits2026-02-21: 10 commits2026-02-22: 6 commits2026-02-23: 14 commits2026-02-24: 13 commits2026-02-25: 7 commits2026-02-26: 5 commits2026-02-27: 2 commits2026-02-28: 3 commits2026-03-01: 37 commits2026-03-02: 12 commits2026-03-03: 4 commits2026-03-04: 1 commit2026-03-05: 0 commits2026-03-06: 3 commits2026-03-07: 3 commits2026-03-08: 5 commits2026-03-09: 1 commit2026-03-10: 19 commits2026-03-11: 14 commits2026-03-12: 19 commits2026-03-13: 0 commits2026-03-14: 0 commits2026-03-15: 6 commits2026-03-16: 8 commits2026-03-17: 7 commits2026-03-18: 16 commits2026-03-19: 35 commits2026-03-20: 7 commits2026-03-21: 26 commits2026-03-22: 16 commits2026-03-23: 12 commits2026-03-24: 21 commits2026-03-25: 39 commits2026-03-26: 8 commits2026-03-27: 1 commit2026-03-28: 3 commits2026-03-29: 1 commit2026-03-30: 8 commits2026-03-31: 10 commits2026-04-01: 60 commits2026-04-02: 24 commits2026-04-03: 2 commits2026-04-04: 0 commits2026-04-05: 2 commits2026-04-06: 0 commits2026-04-07: 2 commits2026-04-08: 11 commits2026-04-09: 0 commits2026-04-10: 2 commits2026-04-11: 11 commits2026-04-12: 8 commits2026-04-13: 1 commit2026-04-14: 3 commits2026-04-15: 8 commits2026-04-16: 0 commits2026-04-17: 0 commits2026-04-18: 0 commits2026-04-19: 1 commit2026-04-20: 23 commits2026-04-21: 2 commits2026-04-22: 1 commit2026-04-23: 3 commits2026-04-24: 1 commit2026-04-25: 0 commits2026-04-26: 2 commits2026-04-27: 0 commits2026-04-28: 0 commits2026-04-29: 0 commits2026-04-30: 2 commits2026-05-01: 5 commits2026-05-02: 3 commits2026-05-03: 0 commits2026-05-04: 2 commits2026-05-05: 2 commits2026-05-06: 4 commits2026-05-07: 0 commits2026-05-08: 2 commits2026-05-09: 3 commits2026-05-10: 0 commits2026-05-11: 2 commits2026-05-12: 0 commits2026-05-13: 1 commit2026-05-14: 0 commits2026-05-15: 0 commits2026-05-16: 0 commits2026-05-17: 1 commit2026-05-18: 30 commits2026-05-19: 5 commits2026-05-20: 3 commits2026-05-21: 0 commits2026-05-22: 19 commits2026-05-23: 12 commits2026-05-24: 0 commits2026-05-25: 6 commits2026-05-26: 0 commits2026-05-27: 0 commits2026-05-28: 0 commits2026-05-29: 0 commits2026-05-30: 0 commits2026-05-31: 0 commits2026-06-01: 7 commits2026-06-02: 53 commits2026-06-03: 196 commits2026-06-04: 61 commits2026-06-05: 55 commits2026-06-06: 8 commits2026-06-07: 0 commits2026-06-08: 28 commits2026-06-09: 13 commits2026-06-10: 1 commit2026-06-11: 6 commits2026-06-12: 5 commits2026-06-13: 2 commits2026-06-14: 0 commits2026-06-15: 2 commits2026-06-16: 0 commits2026-06-17: 0 commits2026-06-18: 0 commits2026-06-19: 0 commits2026-06-20: 7 commits2026-06-21: 0 commits2026-06-22: 0 commits2026-06-23: 0 commits2026-06-24: 0 commits2026-06-25: 0 commits2026-06-26: 8 commits2026-06-27: 3 commits2026-06-28: 1 commit2026-06-29: 15 commits2026-06-30: 0 commits2026-07-01: 27 commits2026-07-02: 2 commits2026-07-03: 2 commits2026-07-04: 1 commit2026-07-05: 0 commits2026-07-06: 18 commits2026-07-07: 32 commits2026-07-08: 6 commits2026-07-09: 10 commits2026-07-10: 2 commits2026-07-11: 5 commits2026-07-12: 3 commits2026-07-13: 1 commit2026-07-14: 2 commits2026-07-15: 8 commits2026-07-16: 11 commits2026-07-17: 0 commits2026-07-18: 1 commit2026-07-19: 0 commits2026-07-20: 3 commits2026-07-21: 2 commits2026-07-22: 32 commits2026-07-23: 12 commits2026-07-24: 17 commits2026-07-25: 1 commit2026-07-26: 0 commits2026-07-27: 3 commits2026-07-28: 4 commits2026-07-29: 1 commit2026-07-30: 4 commits2026-07-31: 1 commit2026-08-01: 0 commits2026-08-02: 59 commits2026-08-03: 10 commits2026-08-04: 9 commits2026-08-05: 0 commits2026-08-06: 2 commits2026-08-07: 0 commits2026-08-08: 0 commits2026-08-09: 0 commits2026-08-10: 0 commits2026-08-11: 2 commits2026-08-12: 3 commits2026-08-13: 12 commits2026-08-14: 0 commits2026-08-15: 11 commits2026-08-16: 2 commits2026-08-17: 4 commits2026-08-18: 2 commits2026-08-19: 6 commits2026-08-20: 7 commits2026-08-21: 0 commits2026-08-22: 0 commits2026-08-23: 0 commits2026-08-24: 6 commits2026-08-25: 9 commits2026-08-26: 8 commits2026-08-27: 22 commits2026-08-28: 20 commits2026-08-29: 8 commits2026-08-30: 20 commits2026-08-31: 3 commits2026-09-01: 9 commits2026-09-02: 5 commits2026-09-03: 25 commits2026-09-04: 23 commits2026-09-05: 6 commits2026-09-06: 2 commits2026-09-07: 5 commits2026-09-08: 1 commit2026-09-09: 21 commits2026-09-10: 0 commits2026-09-11: 0 commits2026-09-12: 4 commits2026-09-13: 4 commits2026-09-14: 0 commits2026-09-15: 3 commits2026-09-16: 0 commits2026-09-17: 0 commits2026-09-18: 0 commits2026-09-19: 0 commits2026-09-20: 0 commits2026-09-21: 0 commits2026-09-22: 0 commits2026-09-23: 3 commits2026-09-24: 0 commits2026-09-25: 0 commits2026-09-26: 1 commit2026-09-27: 1 commit2026-09-28: 0 commits2026-09-29: 3 commits2026-09-30: 0 commits2026-10-01: 12 commits2026-10-02: 19 commits2026-10-03: 0 commits2026-10-04: 0 commits2026-10-05: 0 commits2026-10-06: 8 commits2026-10-07: 4 commits2026-10-08: 0 commits2026-10-09: 0 commits2026-10-10: 0 commits2026-10-11: 0 commits2026-10-12: 0 commits2026-10-13: 3 commits2026-10-14: 0 commits2026-10-15: 41 commits2026-10-16: 16 commits2026-10-17: 35 commits2026-10-18: 0 commits2026-10-19: 0 commits2026-10-20: 0 commits2026-10-21: 0 commits2026-10-22: 5 commits2026-10-23: 0 commits2026-10-24: 0 commits2026-10-25: 0 commits2026-10-26: 4 commits2026-10-27: 0 commits2026-10-28: 0 commits2026-10-29: 3 commits2026-10-30: 0 commits2026-10-31: 0 commits2026-11-01: 0 commits2026-11-02: 0 commits2026-11-03: 0 commits2026-11-04: 142 commits2026-11-05: 82 commits2026-11-06: 132 commits2026-11-07: 192 commits2026-11-08: 258 commits2026-11-09: 229 commits2026-11-10: 22 commits2026-11-11: 0 commits2026-11-12: 0 commits2026-11-13: 0 commits2026-11-14: 0 commits
3,794 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Landmark project

    120,756 stars

  • Very active

    3,794 commits in 52 weeks

  • Community-driven

    ~385 contributors

  • Permissive license

    MIT

  • Continuous integration

    Automated checks passing

  • Repeat trending

    5 trending appearances

  • Top 10% tracked

    Rank 62 of 1220

What browser-use does

This library provides a robust framework bridging large language models with actual web browser instances seamlessly. It allows AI agents to navigate web pages, click elements, extract data, and fill forms dynamically. The system operates by translating high-level natural language intents into concrete Playwright automation commands instantly. It supports various language models including GPT-4 and Claude to drive the underlying navigation logic. Developers can integrate custom functions easily, extending the agent's capabilities to interact with complex web applications.

AI engineers and software developers aiming to build autonomous agents capable of interacting with the real-world web. Researchers experimenting with large language models and practical task completion scenarios.

  • Language model integration: Plugs directly into advanced AI models to drive autonomous web navigation.
  • Playwright automation: Leverages industry-standard browser automation tools to interact with the DOM reliably.
  • Custom action definition: Allows developers to define specific programmatic actions the agent can trigger.
  • Visual feedback: Provides a native user interface for humans to observe the agent's thought process.
  • Context management: Maintains navigation history and DOM state carefully to prevent agent hallucination.

Where teams use it

Automated data extraction

Scrape complex web pages dynamically by commanding an agent to navigate pagination and dropdowns.

Software testing

Execute end-to-end frontend tests using natural language descriptions instead of brittle CSS selectors.

Personal assistance

Delegate routine internet tasks like booking flights or managing calendar appointments to an autonomous agent.

Market research

Gather competitive pricing data automatically across multiple e-commerce platforms using intelligent navigation.

Getting started: pip install browser-use

README

main branch
Shows a black Browser Use Logo in light color mode and a white one in dark color mode.
The AI browser agent.
Browser-Use Package Download Statistics

Demos Docs Blog Merch Github Stars Twitter Discord Browser-Use Cloud

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.02 per browser-hour cloud browser with stealth, CAPTCHA solving and residential proxies, and a hosted agent API. When you add browser-use to a project, pin it exactly (browser-use==1.0.2), never >=: releases move fast and can break APIs.

Which Browser Use do I need?

Three ways to use Browser Use: the hosted V4 agent, the Browser Use CLI, or the open source Python library. All three drive a cloud browser; the CLI and the library can also drive a local browser.

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.

Install browser-use with `uv tool install browser-use==1.0.2`, 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:

uv init --python 3.12 my-agent && cd my-agent
uv add 'browser-use==1.0.2'
export BROWSER_USE_API_KEY=bu_...    # get one at https://cloud.browser-use.com/new-api-key
python3 -m venv .venv && source .venv/bin/activate
pip install 'browser-use==1.0.2'
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.

from browser_use import Agent

result = Agent('Find the number of stars of the browser-use repo').run_sync()
print(result.final_result())

Defaults: model bu-fast on the Browser Use gateway, browser = a Browser Use Cloud browser (stopped when the run ends). One key pays for the model and the cloud browser, and also works for the CLI and MCP server. A .env file works too.

Local browser, your model:

from browser_use import Agent, Browser, ChatOpenAI

agent = Agent(
    'Find the number of stars of the browser-use repo',
    llm=ChatOpenAI('gpt-6-luna'),        # OPENAI_API_KEY; or ChatOpenAI(model, base_url=...) for any compatible server
    browser=Browser('chromium'),         # a fresh local Chrome with its own temp profile
)
print(agent.run_sync().final_result())  # in async code: result = await agent.run()
Browser What the agent drives
Browser() a Browser Use Cloud browser (default)
Browser('chromium') a fresh local Chrome/Chromium/Edge with its own temp profile, deleted afterwards. Headless when there is no display (Docker, CI); headless=, executable_path=, user_data_dir= (a profile dir kept between runs)
Browser('chrome') the Chrome you have open, with your logins (turn on chrome://inspect/#remote-debugging once)
Browser('chrome', profile='Work') a new Chrome on a temporary copy of your Chrome profile Work (sync off); your Chrome can stay open, except on Windows

Other models: ChatAnthropic, ChatGoogle (both built in), or any Pydantic AI model string such as llm='groq:llama-3.3-70b-versatile' (after pip install 'pydantic-ai-slim[groq]').

  • Typed results: Agent(task, output_model_schema=MyModel) then result.structured_output.
  • Uploads: put files in Agent(task, workspace=...) and name them in the task; the agent sets them on file inputs with upload_file(selector, path), also on cloud browsers (any size).
  • Downloads: files the browser downloads land in agent.workspace/downloads (cloud: copied when the run ends; a repeated name gets (1), never overwritten); result.downloads lists the run's files.
  • Secrets: Agent(task, sensitive_data={'password': '...'}), or {'https://*.example.com': {'password': '...'}} to type it only on that domain. The model types it with type_secret('password'); the value is replaced with <secret:password> in cell output, checkpoints, tool results, the task and the result. Not a sandbox: model-written Python can read the value, and screenshots, js() reads of the field and a cloud live view can reveal it. Browser('chromium') and Browser('chrome', profile=...) open a debugging port with no authentication on 127.0.0.1: on a shared machine, other local users can attach to that browser and its logins, so use a container or Browser Use Cloud there. See the trust model in MIGRATING.md.
  • Domain restrictions: Browser(allowed_domains=['example.com', '*.example.org']) (or prohibited_domains=, block_ip_addresses=True) with the 0.x patterns, in every browser mode. A guard for an aligned model, not a sandbox: see the FAQ.
  • Follow-ups: agent.add_new_task('...') then await agent.run(); use Browser(keep_alive=True) to keep the same page between runs.
  • Custom tools: plain functions with @tools.action('description'), then Agent(task, tools=tools).
  • Ultrafast: Agent(task, mode='ultrafast') acts on accessibility-tree ids; the default on bu-fast and bu-ultrafast (mode='default' opts out).
  • Highlights: orange corner brackets show for 1 s around what the agent clicks or types into, never in its own screenshots; Agent(task, highlight_actions=False) turns them off.
  • Web search: the agent gets search(query, num_results=None, category=None) (Browser Use web search, billed per search to your Browser Use key; each charge the response reports is added to result.cost_usd) with Agent(task, web_search=True) (off by default; needs a Browser Use key, and can't be combined with allowed_domains).

Browser Use Benchmark v2

Browser Use Benchmark v2 - Mean rubric score by model and cost per task

This very hard benchmark targets the hardest browser tasks. On easier tasks, even smaller models can achieve very high success rates. Results shown are from a 60-task subset of BU Bench V2.

Integrations, hosting, custom tools, MCP, and more on our Docs ↗

Something broken? browser-use feedback 'what happened' (or browser_use.feedback(...)) sends it straight to the Browser Use team.


FAQ

Should I use the fully hosted cloud, CLI, or Python library?
  • Fully Hosted Cloud: Send tasks through the API and let Browser Use run the agent, browser, and infrastructure.
  • CLI: Give an existing agent (Claude Code, Codex, Hermes, OpenClaw, Pi, Cursor, etc.) browser access. You can use it interactively or in scripts.
  • Python Library: Run the open source agent in your own application, with custom tools, structured output, and your choice of model.

The CLI and Python library can each connect to a local or cloud browser. A cloud browser hosts the browser; the fully hosted API runs the agent as well.

What's the best model to use?

The default, bu-fast on the Browser Use gateway, is gpt-6-luna at medium reasoning. llm='bu-ultrafast' runs the same model at low reasoning on the priority tier (fastest), llm='bu-smart' a larger one. ChatOpenAI('gpt-6-luna') with your own OpenAI key runs the same model directly. See the benchmark.

Can I use this for free?

The Python library is free and MIT-licensed. Model inference and hosted browsers are separate: API providers, including ChatBrowserUse, and Browser Use Cloud charge for usage. You can also use Browser('chromium') with a local model, e.g. Ollama through ChatOpenAI(model, base_url='http://localhost:11434/v1', api_key='ollama').

Terms of Service

This open-source library is licensed under the MIT License. For Browser Use services & data policy, see our Terms of Service and Privacy Policy.

How do I handle authentication?
  • Local browser: Browser('chrome') drives the Chrome you have open, with your logins; Browser('chrome', profile='Work') uses a copy of that profile; Browser('chromium', user_data_dir='~/bu-profile') keeps its own logins between runs.
  • Cloud browser: Browser(cloud_profile_id='work') keeps logins in a cloud profile; see the profile sync guide.
  • Passwords: pass them as sensitive_data; the model types them with type_secret(name) and their values are redacted from cell output, checkpoints, tool results, the task and the result. Not a sandbox: model-written Python can read them, and screenshots, page JavaScript and a cloud live view can reveal a typed value.
How do I solve CAPTCHAs?

Browser Use Cloud provides stealth browsers and proxies designed to reduce bot detection and CAPTCHA challenges. With the Python library, Browser() is a cloud browser by default.

Cloud browsers also solve CAPTCHAs automatically, and the agent waits for the solver with solve_captcha() instead of clicking the challenge. Browser(captcha_solver=False) turns the solver off.

Results depend on the site and challenge; no browser configuration guarantees that every CAPTCHA can be avoided or solved.

Can I limit which sites the agent visits?

Browser(allowed_domains=['example.com', '*.example.org']), Browser(prohibited_domains=['evil.com']) or Browser(block_ip_addresses=True), with the 0.x patterns, on any browser. The browser helpers refuse a disallowed URL, the browser itself blocks main-frame navigations to it (link clicks, redirects, popups, JavaScript; all modes except Browser('chrome') attached to your open Chrome, where a second debugging connection would prompt you again), every tab still on a disallowed page after a cell is reset to about:blank (in Browser('chrome') only the agent's tabs, never yours), and the system prompt lists the domains. A bare domain in prohibited_domains also covers its subdomains.

It is a guard for an aligned model, not a sandbox: requests an allowed page makes to other hosts (fetch, images, iframes) are not filtered, nor is the agent's own Python networking beyond http_get and its redirects. Run untrusted tasks in a container or VM. MIGRATING.md lists exactly what is blocked in each mode.

How do I go into production?

Choose how much you want to manage:

  • Keep your agent code: Connect the CLI or Python library to cloud browsers for managed browser infrastructure, stealth, and profiles.
  • Have us run the agent too: Use the fully hosted Cloud API to submit tasks and retrieve results.

You can also host the Python library and browsers on your own infrastructure.


Related Repositories

Repository What it's for
Browser Use Pi Run a TypeScript browser agent built on Pi.
Cloud SDK Integrate Browser Use Cloud into your application.
Video Use Edit videos with your coding agent.
macOS Harness Give your agent control of Mac apps, browsers, and files.
Benchmark Explore browser tasks and compare agent performance.

Citation

If you use Browser Use in your research or project, please cite:

@software{browser_use2024,
  author = {Müller, Magnus and Žunič, Gregor},
  title = {Browser Use: Enable AI to control your browser},
  year = {2024},
  publisher = {GitHub},
  url = {https://github.com/browser-use/browser-use}
}

Tell your computer what to do, and it gets it done.

Twitter Follow     Twitter Follow

Made with ❤️ in Zurich and San Francisco
View on GitHub

Recent activity

commits and pull requests

Releases and announcements

148 total
  1. browser-use 1.0.21.0.2Nov 11, 2026

    Fixes on 1.0.1. - **MCP with Chrome's remote debugging off:** `browser-use --cli-mcp` now drives its own Chromium instead of stopping at the chrome://inspect steps, and tells your agent how to switch to your Chrome (tick "Allow remote debugging" at chrome://inspect/#remote-debugging, restart the MCP server). - **Slow pages:** CDP calls from the CLI and MCP wait 20 s, like the agent. A page frozen by a JS dialog fails fast with an error that says to handle the dialog. - **Windows:** `open()` in MCP `browser_exec` code reads and writes UTF-8. - **Feedback:** tell us what broke with `browser-use feedback "..."` or `browser_use.feedback("...")`. The agent can call `report_issue(...)` and MCP clients get a `browser_feedback` tool. Text is scrubbed before it leaves. ```bash uv add 'browser-use==1.0.2' ```

  2. 1.0.2rc1: release candidate for 1.0.21.0.2rc1Nov 10, 2026pre-release

    > Release candidate for 1.0.2. Install it explicitly: `pip install 'browser-use==1.0.2rc1'`. Plain installs still get 1.0.1. - `--cli-mcp` with Chrome remote debugging off now drives its own Chromium and tells the model how to get your Chrome (toggle at chrome://inspect, restart the server). - CLI and `--cli-mcp` CDP calls wait 20 s; a page frozen by a JS dialog fails fast with a clear error. - Windows: `open()` in `browser_exec` code defaults to UTF-8. - Feedback: `report_issue` in the agent, `browser-use feedback`, and the `browser_feedback` MCP tool. PR: https://github.com/browser-use/browser-use/pull/6376

  3. browser-use 1.0.11.0.1Nov 10, 2026

    Fixes on 1.0.0. - **MCP without Chrome:** `browser-use --cli-mcp` on servers, containers and CI boxes now drives its own Chromium, installed on first use. When no browser can run, you get one clear error. - **`http_get`** in the CLI and MCP always fetches from your machine. - **`--mcp` with `allowed_domains`** can no longer be bypassed through a cloud browser. - **Windows:** piped CLI code and long MCP output are UTF-8. - **Read-only HOME:** the error names the env var to set. - **`timeout=`:** the final answer arrives before the deadline, and provider retries respect it. - **0.x feature detection:** `hasattr(browser_use, '<removed 0.x name>')` returns `False`. - **Isolation:** each run gets its own browser-harness workspace. ```bash uv add 'browser-use==1.0.1' ```

  4. browser-use 1.0: CDP is all you need1.0.0Nov 10, 20263.6K downloads

    <img src="https://github.com/browser-use/browser-use/releases/download/1.0.0/browser-use-1.0-vs-0.x-bench.png" alt="browser-use 1.0 vs 0.x: higher score, cheaper, faster, 80% less code" width="100%"> ## −136,866 lines. 80% of the library deleted. We started over. The agent now writes Python in one persistent REPL, straight on Chrome DevTools Protocol. No DOM serializer, no action schema, nothing in between. Simplicity wins: it is now the [state-of-the-art web agent](https://browser-use.com/benchmarks). ``` ● task │ ● model writes a cell new_tab(url); bu.click(41); js(...) │ ● REPL runs it on Chrome (CDP) → output back to the model │ ✓ finish(result) ``` **Same models: up to 33 points higher, 2.7–5.2x cheaper, 2–3x faster.** ```bash uv add 'browser-use==1.0.0' export BROWSER_USE_API_KEY=bu_... # cloud.browser-use.com/new-api-key ``` ```python from browser_use import Agent print(Agent('Find the number of stars of the browser-use repo').run_sync().final_result()) ``` Pin with `==`. We ship fast from here. <details> <summary><b>Upgrading from 0.x, benchmarks, everything that changed</b></summary> Need 0.x? `pip install 'browser-use<1'` ### What chan

  5. > Release candidate (second one published, after 1.0.0rc4). Install it explicitly. Plain `pip install browser-use` and `uv add browser-use` still give you 0.13.14 until 1.0.0 ships. Please report problems at https://github.com/browser-use/browser-use/issues and say you are on 1.0.0rc5. browser-use 1.0 replaces the engine. The agent no longer picks one action per step from a DOM dump. It writes Python in one persistent REPL with the [browser-harness](https://github.com/browser-use/browser-harness) helpers and raw CDP, on [Pydantic AI](https://ai.pydantic.dev). The library went from 68,815 to 13,154 lines of Python. The 0.x surface you use most (`Agent`, `Browser`, `Tools`, `run()`, `final_result()`) still works. ### Install ```bash uv add 'browser-use==1.0.0rc5' export BROWSER_USE_API_KEY=bu_... # get one at https://cloud.browser-use.com/new-api-key ``` or `pip install 'browser-use==1.0.0rc5'`. CLI only: `uv tool install 'browser-use==1.0.0rc5'`. Python 3.11 or newer. ```python from browser_use import Agent result = Agent('Find the number of stars of the browser-use repo').run_sync() print(result.final_result()) ``` ### What changes by default | | 0.x | 1.0 | |---|---|--

Code frequency

additions and deletions
+28.3K-28.3KWeek of 2025-08-03: +22,212 linesWeek of 2025-08-03: -20,574 linesWeek of 2025-08-10: +14,638 linesWeek of 2025-08-10: -10,050 linesWeek of 2025-08-17: +17,002 linesWeek of 2025-08-17: -19,599 linesWeek of 2025-08-24: +16,300 linesWeek of 2025-08-24: -28,275 linesWeek of 2025-08-31: +6,130 linesWeek of 2025-08-31: -6,820 linesWeek of 2025-09-07: +5,472 linesWeek of 2025-09-07: -2,193 linesWeek of 2025-09-14: +9,927 linesWeek of 2025-09-14: -3,598 linesWeek of 2025-09-21: +794 linesWeek of 2025-09-21: -561 linesWeek of 2025-09-28: +1,283 linesWeek of 2025-09-28: -239 linesWeek of 2025-10-05: +2,308 linesWeek of 2025-10-05: -1,780 linesWeek of 2025-10-12: +6,558 linesWeek of 2025-10-12: -4,850 linesWeek of 2025-10-19: +18,572 linesWeek of 2025-10-19: -18,180 linesWeek of 2025-10-26: +9,149 linesWeek of 2025-10-26: -3,776 linesWeek of 2025-11-02: +8,757 linesWeek of 2025-11-02: -2,640 linesWeek of 2025-11-09: +2,137 linesWeek of 2025-11-09: -1,476 linesWeek of 2025-11-16: +4,575 linesWeek of 2025-11-16: -1,392 linesWeek of 2025-11-23: +2,761 linesWeek of 2025-11-23: -3,119 linesWeek of 2025-11-30: +1,828 linesWeek of 2025-11-30: -124 linesWeek of 2025-12-07: +2,117 linesWeek of 2025-12-07: -808 linesWeek of 2025-12-14: +1,259 linesWeek of 2025-12-14: -261 linesWeek of 2025-12-21: +2,081 linesWeek of 2025-12-21: -193 linesWeek of 2025-12-28: +0 linesWeek of 2025-12-28: -146 linesWeek of 2026-01-04: +526 linesWeek of 2026-01-04: -66 linesWeek of 2026-01-11: +480 linesWeek of 2026-01-11: -10 linesWeek of 2026-01-18: +5,259 linesWeek of 2026-01-18: -2,032 linesWeek of 2026-01-25: +7,133 linesWeek of 2026-01-25: -1,367 linesWeek of 2026-02-01: +4,112 linesWeek of 2026-02-01: -1,508 linesWeek of 2026-02-08: +11,497 linesWeek of 2026-02-08: -4,723 linesWeek of 2026-02-15: +2,725 linesWeek of 2026-02-15: -1,461 linesWeek of 2026-02-22: +1,698 linesWeek of 2026-02-22: -338 linesWeek of 2026-03-01: +1,887 linesWeek of 2026-03-01: -6,087 linesWeek of 2026-03-08: +1,177 linesWeek of 2026-03-08: -7,061 linesWeek of 2026-03-15: +13,868 linesWeek of 2026-03-15: -12,111 linesWeek of 2026-03-22: +3,146 linesWeek of 2026-03-22: -803 linesWeek of 2026-03-29: +9,481 linesWeek of 2026-03-29: -8,905 linesWeek of 2026-04-05: +302 linesWeek of 2026-04-05: -177 linesWeek of 2026-04-12: +57 linesWeek of 2026-04-12: -135 linesWeek of 2026-04-19: +953 linesWeek of 2026-04-19: -117 linesWeek of 2026-04-26: +33 linesWeek of 2026-04-26: -25 linesWeek of 2026-05-03: +456 linesWeek of 2026-05-03: -66 linesWeek of 2026-05-10: +42 linesWeek of 2026-05-10: -8 linesWeek of 2026-05-17: +1,871 linesWeek of 2026-05-17: -544 linesWeek of 2026-05-24: +9 linesWeek of 2026-05-24: -11 linesWeek of 2026-05-31: +21,604 linesWeek of 2026-05-31: -6,656 linesWeek of 2026-06-07: +16,189 linesWeek of 2026-06-07: -14,970 linesWeek of 2026-06-14: +498 linesWeek of 2026-06-14: -11 linesWeek of 2026-06-21: +474 linesWeek of 2026-06-21: -466 linesWeek of 2026-06-28: +1,708 linesWeek of 2026-06-28: -12,531 linesWeek of 2026-07-05: +1,353 linesWeek of 2026-07-05: -549 linesWeek of 2026-07-12: +103 linesWeek of 2026-07-12: -9 linesWeek of 2026-07-19: +1,339 linesWeek of 2026-07-19: -365 linesWeek of 2026-07-26: +0 linesWeek of 2026-07-26: -0 linesAug 3, 2025Jul 26, 2026
+265.8K lines added, -213.8K removed over the last year.

Commits per week

last 52 weeks
5480Week of 2025-11-16: 107 commitsWeek of 2025-11-23: 98 commitsWeek of 2025-11-30: 24 commitsWeek of 2025-12-07: 43 commitsWeek of 2025-12-14: 52 commitsWeek of 2025-12-21: 27 commitsWeek of 2025-12-28: 2 commitsWeek of 2026-01-04: 20 commitsWeek of 2026-01-11: 21 commitsWeek of 2026-01-18: 45 commitsWeek of 2026-01-25: 144 commitsWeek of 2026-02-01: 88 commitsWeek of 2026-02-08: 168 commitsWeek of 2026-02-15: 64 commitsWeek of 2026-02-22: 50 commitsWeek of 2026-03-01: 60 commitsWeek of 2026-03-08: 58 commitsWeek of 2026-03-15: 105 commitsWeek of 2026-03-22: 100 commitsWeek of 2026-03-29: 105 commitsWeek of 2026-04-05: 28 commitsWeek of 2026-04-12: 20 commitsWeek of 2026-04-19: 31 commitsWeek of 2026-04-26: 12 commitsWeek of 2026-05-03: 13 commitsWeek of 2026-05-10: 3 commitsWeek of 2026-05-17: 70 commitsWeek of 2026-05-24: 6 commitsWeek of 2026-05-31: 380 commitsWeek of 2026-06-07: 55 commitsWeek of 2026-06-14: 9 commitsWeek of 2026-06-21: 11 commitsWeek of 2026-06-28: 48 commitsWeek of 2026-07-05: 73 commitsWeek of 2026-07-12: 26 commitsWeek of 2026-07-19: 67 commitsWeek of 2026-07-26: 13 commitsWeek of 2026-08-02: 80 commitsWeek of 2026-08-09: 28 commitsWeek of 2026-08-16: 21 commitsWeek of 2026-08-23: 73 commitsWeek of 2026-08-30: 91 commitsWeek of 2026-09-06: 33 commitsWeek of 2026-09-13: 7 commitsWeek of 2026-09-20: 4 commitsWeek of 2026-09-27: 35 commitsWeek of 2026-10-04: 12 commitsWeek of 2026-10-11: 95 commitsWeek of 2026-10-18: 5 commitsWeek of 2026-10-25: 7 commitsWeek of 2026-11-01: 548 commitsWeek of 2026-11-08: 509 commitsNov 16, 2025Nov 8, 2026
3.8K commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 41 commitsSun 1:00 — 27 commitsSun 2:00 — 13 commitsSun 3:00 — 8 commitsSun 4:00 — 4 commitsSun 5:00 — 6 commitsSun 6:00 — 10 commitsSun 7:00 — 12 commitsSun 8:00 — 22 commitsSun 9:00 — 19 commitsSun 10:00 — 28 commitsSun 11:00 — 54 commitsSun 12:00 — 68 commitsSun 13:00 — 36 commitsSun 14:00 — 48 commitsSun 15:00 — 55 commitsSun 16:00 — 60 commitsSun 17:00 — 79 commitsSun 18:00 — 42 commitsSun 19:00 — 42 commitsSun 20:00 — 47 commitsSun 21:00 — 80 commitsSun 22:00 — 50 commitsSun 23:00 — 48 commitsMon 0:00 — 22 commitsMon 1:00 — 21 commitsMon 2:00 — 10 commitsMon 3:00 — 6 commitsMon 4:00 — 6 commitsMon 5:00 — 7 commitsMon 6:00 — 9 commitsMon 7:00 — 15 commitsMon 8:00 — 27 commitsMon 9:00 — 28 commitsMon 10:00 — 61 commitsMon 11:00 — 57 commitsMon 12:00 — 49 commitsMon 13:00 — 66 commitsMon 14:00 — 65 commitsMon 15:00 — 80 commitsMon 16:00 — 90 commitsMon 17:00 — 97 commitsMon 18:00 — 91 commitsMon 19:00 — 41 commitsMon 20:00 — 57 commitsMon 21:00 — 77 commitsMon 22:00 — 62 commitsMon 23:00 — 52 commitsTue 0:00 — 42 commitsTue 1:00 — 28 commitsTue 2:00 — 42 commitsTue 3:00 — 34 commitsTue 4:00 — 14 commitsTue 5:00 — 25 commitsTue 6:00 — 25 commitsTue 7:00 — 29 commitsTue 8:00 — 31 commitsTue 9:00 — 23 commitsTue 10:00 — 47 commitsTue 11:00 — 56 commitsTue 12:00 — 83 commitsTue 13:00 — 64 commitsTue 14:00 — 78 commitsTue 15:00 — 66 commitsTue 16:00 — 75 commitsTue 17:00 — 89 commitsTue 18:00 — 90 commitsTue 19:00 — 55 commitsTue 20:00 — 40 commitsTue 21:00 — 69 commitsTue 22:00 — 72 commitsTue 23:00 — 80 commitsWed 0:00 — 39 commitsWed 1:00 — 36 commitsWed 2:00 — 33 commitsWed 3:00 — 11 commitsWed 4:00 — 4 commitsWed 5:00 — 4 commitsWed 6:00 — 15 commitsWed 7:00 — 19 commitsWed 8:00 — 29 commitsWed 9:00 — 47 commitsWed 10:00 — 64 commitsWed 11:00 — 78 commitsWed 12:00 — 63 commitsWed 13:00 — 48 commitsWed 14:00 — 60 commitsWed 15:00 — 59 commitsWed 16:00 — 78 commitsWed 17:00 — 78 commitsWed 18:00 — 49 commitsWed 19:00 — 62 commitsWed 20:00 — 67 commitsWed 21:00 — 78 commitsWed 22:00 — 97 commitsWed 23:00 — 83 commitsThu 0:00 — 65 commitsThu 1:00 — 23 commitsThu 2:00 — 29 commitsThu 3:00 — 8 commitsThu 4:00 — 14 commitsThu 5:00 — 20 commitsThu 6:00 — 12 commitsThu 7:00 — 20 commitsThu 8:00 — 20 commitsThu 9:00 — 35 commitsThu 10:00 — 67 commitsThu 11:00 — 82 commitsThu 12:00 — 50 commitsThu 13:00 — 35 commitsThu 14:00 — 69 commitsThu 15:00 — 41 commitsThu 16:00 — 63 commitsThu 17:00 — 59 commitsThu 18:00 — 82 commitsThu 19:00 — 71 commitsThu 20:00 — 57 commitsThu 21:00 — 51 commitsThu 22:00 — 60 commitsThu 23:00 — 70 commitsFri 0:00 — 55 commitsFri 1:00 — 57 commitsFri 2:00 — 48 commitsFri 3:00 — 33 commitsFri 4:00 — 15 commitsFri 5:00 — 25 commitsFri 6:00 — 9 commitsFri 7:00 — 11 commitsFri 8:00 — 23 commitsFri 9:00 — 22 commitsFri 10:00 — 31 commitsFri 11:00 — 37 commitsFri 12:00 — 36 commitsFri 13:00 — 44 commitsFri 14:00 — 51 commitsFri 15:00 — 47 commitsFri 16:00 — 52 commitsFri 17:00 — 67 commitsFri 18:00 — 87 commitsFri 19:00 — 83 commitsFri 20:00 — 64 commitsFri 21:00 — 54 commitsFri 22:00 — 42 commitsFri 23:00 — 61 commitsSat 0:00 — 42 commitsSat 1:00 — 36 commitsSat 2:00 — 20 commitsSat 3:00 — 37 commitsSat 4:00 — 27 commitsSat 5:00 — 23 commitsSat 6:00 — 19 commitsSat 7:00 — 19 commitsSat 8:00 — 32 commitsSat 9:00 — 46 commitsSat 10:00 — 55 commitsSat 11:00 — 57 commitsSat 12:00 — 54 commitsSat 13:00 — 31 commitsSat 14:00 — 31 commitsSat 15:00 — 46 commitsSat 16:00 — 32 commitsSat 17:00 — 55 commitsSat 18:00 — 74 commitsSat 19:00 — 37 commitsSat 20:00 — 40 commitsSat 21:00 — 47 commitsSat 22:00 — 37 commitsSat 23:00 — 58 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.
DateListRankStars gained
Sep 9, 2026daily#9+330
Sep 8, 2026daily#9+330
Mar 24, 2026daily#19+130
Mar 23, 2026daily#15+143
Jan 24, 2026daily#18+162
  • public-apis/public-apis

    A collective list of free APIs

    498.3K stars · Python

  • morluto/rea

    Reverse engineer anything with agents, from app behavior down to native binaries.

    453.1K stars · TypeScript

  • donnemartin/system-design-primer

    Learn how to design large-scale systems. Prep for the system design interview. Includes Anki flashcards.

    377.6K stars · Python

  • affaan-m/ECC

    The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

    301.5K stars · JavaScript

  • practical-tutorials/project-based-learning

    Curated list of project-based tutorials

    289.6K stars · Python

  • NousResearch/hermes-agent

    The agent that grows with you

    262.8K stars · Python