NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1353 most downloaded on PyPI
Make websites accessible for AI agents
Last release 1 months ago
04 Sep 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
2 years old
139 releases · first in 2024
One column per month.
…CodeQL, GitGuardian, and an installed-runtime vulnerability audit.
Validation includes the full GitHub test matrix, model adapters, MCP stdio handshakes, cross-platform wheel installation, focused PDF tests, CodeQL, GitGuardian, and an installed-runtime vulnerability audit.
fix(deps): update vulnerable Click, MCP, and pypdf pins by @green3sf in #5526
Full Changelog: 0.13.8...0.13.9
fix(mcp): update deprecated Bedrock Claude model identifier by @scemii in #5448
Full Changelog: 0.13.7...0.13.8
Ships the latest version of the CLI, which includes bug fixes and better browser management.
Ships the latest version of the CLI, which includes bug fixes and better browser management.
Full Changelog: 0.13.6...0.13.7
Release 0.13.6 with Browser Harness 0.1.6 by @gregpr07 in #5245
Full Changelog: 0.13.5...0.13.6
Update README.md by @ShawnPana in #5197
Full Changelog: 0.13.4...0.13.5
MCP server for CLI 3.0: shared MCP runner, max_dim guard.
max_dim guard.0.1.5 (Windows reliability fixes, cloud-browser suggestion).Full Changelog: 0.13.3...0.13.4
Launch Browser Use CLI 3.0 powered by Browser Harness.
browser-use skill so coding agents can install the Browser Use skill directly.0.1.4 and ship the Browser Use skill with the package.Full Changelog: 0.13.2...0.13.3
support claude fable 5 by @laithrw in #5008
Browser Use 0.13.0 introduces a new Rust-backed beta agent.
<img width="2912" height="1632" alt="browser-use_a_hooded_traveler_in_saffron_robes_with_a_long_staf_99dc26d6-efe0-4f9b-b2ea-7329f26cdb2a (1)-2" src="https://github.com/user-attachments/assets/d6f49f19-ccb7-4284-afe1-4bad0fa228ae" />
<br/>
Browser Use 0.13.0 introduces a new Rust-backed beta agent.
It gives modern models a more direct browser control loop, guided by robust helpers instead of brittle browser abstractions.
uv add "browser-use[core]"
from browser_use.beta import Agent
The existing Python agent remains unchanged.
Full Changelog: https://github.com/browser-use/browser-use/compare/0.12.9...0.13.0
Browser Use 0.13.0 introduces a new Rust-backed beta agent.
It gives modern models a more direct browser control loop, guided by robust helpers instead of brittle browser abstractions.
uv add "browser-use[core]"from browser_use.beta import AgentThe existing Python agent remains unchanged.
Full Changelog: 0.12.9...0.13.0
bump browser-use package version to 0.13.0rc4
Full uv sync --all-extras / install validation must wait until
browser-use-core==0.13.0rc4 finishes publishing from terminal run
https://github.com/browser-use/terminal/actions/runs/27166198498.
Prepare rc4 release by bumping browser-use to 0.13.0rc4 and aligning
the [core] extra to browser-use-core 0.13.0rc4 across all platforms.
This keeps the wrapper and core in sync for clean installs.
Dependencies
browser-use version to 0.13.0rc4.Pin browser-use-core==0.13.0rc4 for macOS (arm64, x86_64), Linux
(x86_64, aarch64), and Windows (x86_64).
Migration
No code changes. Install [core] after browser-use-core 0.13.0rc4
is published.
Written for commit 5fea46d.
Summary will update on new commits.
Nothing published for this version
Nothing published for this version
Pass session id to judge LLM calls by @MagMueller in https://github.com/browser-use/browser-use/pull/4918
Full Changelog: https://github.com/browser-use/browser-use/compare/0.12.8...0.12.9
fix(daemon): restrict unix socket file to owner-only access by @sauravpanda in https://github.com/browser-use/browser-use/pull/4870
Full Changelog: https://github.com/browser-use/browser-use/compare/0.12.7...0.12.8
fix: upgrade aiohttp to 3.13.4 to patch memory exhaustion vulnerability by @sauravpanda in https://github.com/browser-use/browser-use/pull/4596
record start/stop CLI command for session video capture by @sauravpanda in https://github.com/browser-use/browser-use/pull/4710'type' from second elif branch in optimize_schema() by @kuishou68 in https://github.com/browser-use/browser-use/pull/4704Full Changelog: https://github.com/browser-use/browser-use/compare/0.12.6...0.12.7
fix: set default temperature to 1.0 for gemini-3 models by @markmcd in https://github.com/browser-use/browser-use/pull/4489
<img width="1661" height="278" alt="image" src="https://github.com/user-attachments/assets/151c26e2-b7d8-47e6-b628-1121677527ee" />
Full Changelog: https://github.com/browser-use/browser-use/compare/0.12.5...0.12.6
Remove litellm from core dependencies in response to the litellm supply chain attack (versions 1.82.7 & 1.82.8 backdoored on March 24, 2026).
Remove litellm from core dependencies in response to the litellm supply chain attack (versions 1.82.7 & 1.82.8 backdoored on March 24, 2026).
pip install browser-use no longer installs litellmChatLiteLLM wrapper is preserved — install litellm separately if needed: pip install litellmSee: https://github.com/browser-use/browser-use/pull/4515
fix: detect uv installed via curl script by @ishan0102 in https://github.com/browser-use/browser-use/pull/4478
Full Changelog: https://github.com/browser-use/browser-use/compare/0.12.3...0.12.4
fix open security advisories: restrict workflow permissions, bump vulnerable deps, remove unused authlib by @laithrw in https://github.com/browser-use…
The fastest browser automation for AI coding agents. 2x faster, 50% fewer tokens, and works with any CLI agent — Claude Code, Codex, and more.
Built on direct CDP (Chrome DevTools Protocol) instead of Playwright, giving ~50ms command latency via a persistent background daemon.
https://github.com/user-attachments/assets/a604895b-4ff9-47be-8161-56c48773f93b
# Install the CLI
curl -fsSL https://browser-use.com/cli/install.sh | bash
# Install the skill (for Claude Code / Codex)
mkdir -p ~/.claude/skills/browser-use
curl -o ~/.claude/skills/browser-use/SKILL.md \
https://raw.githubusercontent.com/browser-use/browser-use/main/skills/browser-use/SKILL.md
Works with any CLI coding agent — Claude Code, Codex, OpenClaw, and more. Just install the CLI and the skill.
browser-use open https://example.com # Navigate (starts browser if needed)
browser-use state # Returns clickable elements: [0] button "Submit", [1] input "Email"...
browser-use click 0 # Click by index
browser-use input 3 "hello@example.com" # Click element, then type
browser-use type "search query" # Type into focused element
browser-use screenshot page.png # See the page
browser-use close # Done
The CLI uses element indices from state — no selectors to maintain. browser-use state is optimized for agents: fast, token-efficient, and returns every interactable element on the page.
| Mode | Command | Description |
|---|---|---|
| Headless | browser-use open <url> |
Default, fast, invisible |
| Headed | browser-use --headed open <url> |
Visible window for debugging |
| Real Chrome | browser-use --profile "Default" open <url> |
Your Chrome with existing logins & cookies |
| Connect | browser-use --connect open <url> |
Auto-discover and attach to running Chrome via CDP |
| CDP URL | browser-use --cdp-url ws://localhost:9222/... open <url> |
Connect to any browser via CDP URL |
| ☁️ Cloud | browser-use cloud connect |
Stealth cloud browser + proxies included |
Chrome only. The CLI uses Chrome DevTools Protocol (CDP), which is Chrome/Chromium-specific. Safari and Firefox are not supported.
Cloud browser requires
BROWSER_USE_API_KEYfrom cloud.browser-use.com. Cloud gives you agent-ready browsers with anti-detection, proxies, and massive parallelization.
One of the most requested features — connect to your already-running Chrome with all your logins, cookies, and extensions:
# Auto-discover running Chrome's CDP endpoint
browser-use --connect open https://github.com
# Or use an existing Chrome profile directly
browser-use --profile "Default" open https://github.com # Already logged in!
browser-use --profile "Profile 1" open https://gmail.com # Named profile
# List available profiles
browser-use profile list
Tip for WSL2 users: Add
browser-use --cdp-urlto your CLAUDE.md to control the host browser from WSL2.
browser-use -s work open https://work.example.com
browser-use -s personal open https://gmail.com
browser-use sessions # List all
browser-use close --all # Close all
The CLI excels at form filling and complex interactions:
browser-use input 5 "user@example.com" # Fill email field
browser-use input 6 "password123" # Fill password
browser-use click 7 # Submit button
browser-use select 3 "United States" # Dropdown selection
browser-use upload 4 ./resume.pdf # Upload a file
browser-use hover 2 # Hover over element
browser-use keys "Enter" # Send keyboard keys
browser-use get title # Page title
browser-use get html --selector "table" # Scoped HTML
browser-use get text 5 # Element text
browser-use eval "document.title" # Run JavaScript
browser-use screenshot --full page.png # Full-page screenshot
browser-use python "browser.goto('https://example.com')"
browser-use python "items = browser.html"
browser-use python "print(len(items))" # Variables persist across calls
browser-use python --vars # Show defined variables
browser-use tunnel 3000 # → https://abc.trycloudflare.com
browser-use open https://abc.trycloudflare.com
browser-use tunnel stop --all
The CLI doesn't use screenshots or image detection. Instead, it directly reads the browser's DOM tree via CDP and returns structured, token-efficient element data. Your coding agent processes the content; the CLI handles browser context and command execution. Every command shares the same battle-tested implementation as the browser-use Python library.
Architecture: A background daemon keeps the browser alive between commands, so there's no startup cost per command — just ~50ms latency.
Does it work with Codex / other CLI agents? Yes — it works with any CLI coding agent. Install the CLI and the skill file.
Can it run headless?
Yes, headless is the default. Use --headed when you want to see the browser.
How does it compare to the Claude Chrome extension? The Browser Use CLI is also free, faster and more token efficient, doesn't require a Chrome extension, and works with any CLI agent (not just Claude).
How does it compare to Vercel Agent Browser? 2x the speed for half the cost with half the commands.
Does it work with Safari/Firefox? No — it uses Chrome DevTools Protocol (CDP), which is Chrome/Chromium only.
Can it upload files?
Yes! Use browser-use upload <index> <path>.
What about security/pentesting? Yes — popular use cases include form filling, QA/pentesting, and general web automation.
Full Changelog: https://github.com/browser-use/browser-use/compare/0.12.2...0.12.3
don't explicitly pass newWindow: false to CDP createTarget by @laithrw in https://github.com/browser-use/browser-use/pull/4283
Full Changelog: https://github.com/browser-use/browser-use/compare/0.12.1...0.12.2
Fix proxy auth attach handler overwriting tab tracking by @laithrw in https://github.com/browser-use/browser-use/pull/4220
Full Changelog: https://github.com/browser-use/browser-use/compare/0.12.0...0.12.1
improved csv file generation by @sauravpanda in https://github.com/browser-use/browser-use/pull/4213
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.13...0.12.0
updated laminar version by @sauravpanda in https://github.com/browser-use/browser-use/pull/4154
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.12...0.11.13
Fix CDP connectivity issues by @LarsenCundric in https://github.com/browser-use/browser-use/pull/4135
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.11...0.11.12
fix(#3895): stop agent if browser closed by @laithrw in https://github.com/browser-use/browser-use/pull/4056
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.9...0.11.11
Fix download monitoring issues with fetch requests and blob downloads by @sandeepsalwan1 in https://github.com/browser-use/browser-use/pull/3518
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.10a1...0.11.10a2
fix(#3895): stop agent if browser closed by @laithrw in https://github.com/browser-use/browser-use/pull/4056
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.9...0.11.10a1
added basic planing to agents by @sauravpanda in https://github.com/browser-use/browser-use/pull/4008
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.8...0.11.9
docs: add quotes around browser-use[cli] for shell compatibility by @ShawnPana in https://github.com/browser-use/browser-use/pull/4002
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.7...0.11.8
add grep tool to agent by @sauravpanda in https://github.com/browser-use/browser-use/pull/3997
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.6...0.11.7
fix(#3264): clear agent eventbus, not just browser session's by @laithrw in https://github.com/browser-use/browser-use/pull/3964
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.5...0.11.6
Release: 0.11.5 - Browser Use Model bu-2-0 🚀
<html><head></head><body><h1>Release: 0.11.5 - Browser Use Model bu-2-0 🚀</h1> <p>We're excited to announce <strong>bu-2-0</strong>, our latest premium model for browser automation.</p> <h2>What's New</h2> <p><strong>bu-2-0</strong> delivers a significant leap in accuracy while maintaining the speed that made bu-1-0 the fastest web agent:</p>
| Metric | bu-1-0 | bu-2-0 |
|---|---|---|
| Accuracy | 74.7% | 83.3% (+12%) |
| Speed | 58s/task | 60s/task (≈ same) |
<h2>Quick Start</h2> <pre><code class="language-python">from browser_use import Agent, ChatBrowserUse <br> llm = ChatBrowserUse(model='bu-2-0') <br> agent = Agent( task="Your task here", llm=llm )
await agent.run() </code></pre> <h2>Environment Setup</h2> <pre><code class="language-bash">export BROWSER_USE_API_KEY=your_api_key_here </code></pre> <p>Get your API key at <a href="https://cloud.browser-use.com/new-api-key">cloud.browser-use.com</a></p></body></html>
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.4...0.11.5
Give your Claude Code/Codex agent access to local and remote browsers. Really helpful for local dev.
Give your Claude Code/Codex agent access to local and remote browsers. Really helpful for local dev.
<img width="669" height="523" alt="local-qa" src="https://github.com/user-attachments/assets/0fa045c8-bcd2-4ff2-bd21-57300ab36c93" />
<br />
browser-use open https://example.com # Navigate
browser-use state # Returns clickable elements: [0] button "Submit", [1] input "Email"...
browser-use click 0 # Click by index
browser-use type "hello@example.com" # Type text
browser-use screenshot page.png # See the page
browser-use close # Done
Just install the skill and ask Claude to browse:
mkdir -p ~/.claude/skills/browser-use
curl -o ~/.claude/skills/browser-use/SKILL.md \
https://raw.githubusercontent.com/browser-use/browser-use/main/skills/browser-use/SKILL.md
| Mode | Command | Description |
|---|---|---|
| Headless | browser-use open <url> |
Default, fast |
| Headed | browser-use open --headed <url> |
Visible window |
| Real Chrome | browser-use --browser real open <url> |
Your Chrome with existing logins |
| ☁️ Cloud | browser-use --browser remote open <url> |
Stealth browser + proxies included |
Cloud browser requires
BROWSER_USE_API_KEYfrom cloud.browser-use.com. Proxies and anti-detection are automatic - just use--browser remote. Returns a live preview URL.
browser-use -s work open https://work.example.com
browser-use -s personal open https://gmail.com
browser-use sessions # List all
browser-use close --all # Close all
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.3...0.11.4
Bu_oss example flash mode by @mertunsall in https://github.com/browser-use/browser-use/pull/3774
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.2...0.11.3
We released an open source model specialized in Browser Use https://huggingface.co/browser-use/bu-30b-a3b-preview.
We released an open source model specialized in Browser Use https://huggingface.co/browser-use/bu-30b-a3b-preview.
Check it out 🚀
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.1...0.11.2
docs: fix default action count in docs by @sauravpanda in https://github.com/browser-use/browser-use/pull/3741
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.0...0.11.1
```python from browser_use import Agent, ChatBrowserUse
from browser_use import Agent, ChatBrowserUse
agent = Agent(
task='Your task',
skills=['skill-uuid-1', 'skill-uuid-2'], # Specific skills (recommended)
# or
# skills=['*'], # All skills
llm=ChatBrowserUse()
)
await agent.run()
Full Changelog: https://github.com/browser-use/browser-use/compare/0.10.1...0.11.0
Release again because forgot to bump pyproject :)
Release again because forgot to bump pyproject :)
Full Changelog: https://github.com/browser-use/browser-use/compare/0.10.0...0.10.1
Nothing published for this version
Fix: Ignore Inert Carousel Elements by @PredictiveManish in https://github.com/browser-use/browser-use/pull/3564
Full Changelog: https://github.com/browser-use/browser-use/compare/0.9.6...0.9.7
Remove deprecated agent.context documentation by @mertunsall in https://github.com/browser-use/browser-use/pull/3561
Full Changelog: https://github.com/browser-use/browser-use/compare/0.9.5...0.9.6
small-fixes2 by @MagMueller in https://github.com/browser-use/browser-use/pull/3457
Full Changelog: https://github.com/browser-use/browser-use/compare/0.9.4...0.9.5
make pip workflow funciton by installing uv from pip by @Alezander9 in https://github.com/browser-use/browser-use/pull/3454
Full Changelog: https://github.com/browser-use/browser-use/compare/0.9.3...0.9.4
Add DOM serializer test with shadow DOM, iframes, and click functionality by @MagMueller in https://github.com/browser-use/browser-use/pull/3435
Full Changelog: https://github.com/browser-use/browser-use/compare/0.9.2...0.9.3
bug-template by @MagMueller in https://github.com/browser-use/browser-use/pull/3416
uvx browser-use install by @ShawnPana in https://github.com/browser-use/browser-use/pull/3429Full Changelog: https://github.com/browser-use/browser-use/compare/0.9.1...0.9.2
readme faq by @MagMueller in https://github.com/browser-use/browser-use/pull/3390
Full Changelog: https://github.com/browser-use/browser-use/compare/0.9.0...0.9.1
Just import the CodeAgent. The APIs are compatible.
<img width="830" height="274" alt="code-use" src="https://github.com/user-attachments/assets/ea7e1a0d-c6e6-46e6-9f40-751ee880ac4c" />
Just import the CodeAgent. The APIs are compatible.
from browser_use import CodeAgent, ChatBrowserUse
agent = CodeAgent(
task=task,
llm=ChatBrowserUse(), # requires our special LLM
)
await agent.run()
We have new highlights which show where the agent clicked:
We have new highlights which show where the agent clicked: <img width="818" height="350" alt="image" src="https://github.com/user-attachments/assets/8bae4e2a-856a-48a6-8a35-03c83946d805" />
Full Changelog: https://github.com/browser-use/browser-use/compare/0.8.0...0.8.1
## New light speed LLMs available Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.12...0.8.0
<img width="651" height="223" alt="image" src="https://github.com/user-attachments/assets/7667fbb3-629c-4de6-87f3-e3eed1a689ed" />
Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.12...0.8.0
0.7.12 by @gregpr07 in https://github.com/browser-use/browser-use/pull/3274
Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.11...0.7.12
fix the spelling mistakes in the using_cdp example by @Cu1111 in https://github.com/browser-use/browser-use/pull/3190
Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.10...0.7.11
speed-ups by @MagMueller in https://github.com/browser-use/browser-use/pull/3172
Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.9...0.7.10
```python from browser_use import Browser, Agent from browser_use.llm.openai import ChatOpenAI
from browser_use import Browser, Agent
from browser_use.llm.openai import ChatOpenAI
async def main():
llm = ChatOpenAI(api_key="your-api-key")
browser = Browser()
await browser.start()
# 1. Actor: Precise navigation and element interactions
page = await browser.new_page("https://github.com/login")
email_input = await page.must_get_element_by_prompt("username field", llm=llm)
await email_input.fill("your-username")
# 2. Agent: AI-driven complex tasks
agent = Agent(browser=browser, llm=llm)
await agent.run("Complete login and navigate to my repositories")
await browser.stop()
Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.8...0.7.9
Modify Ad-Use README to add license by @avocardio in https://github.com/browser-use/browser-use/pull/3053
<img width="830" height="274" alt="bu-writes-code" src="https://github.com/user-attachments/assets/614de98b-1402-40f6-a33d-84fea22cb7c1" />
Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.7...0.7.8
feat: Add enhanced screenshot API by @avocardio in https://github.com/browser-use/browser-use/pull/3012
Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.6...0.7.7
remove 2 longer tests because this test mainly shows if browseruse works end to end by @MagMueller in https://github.com/browser-use/browser-use/pull/
Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.5...0.7.6
qwen support by @MagMueller in https://github.com/browser-use/browser-use/pull/2997
<img width="830" height="274" alt="0 7 5" src="https://github.com/user-attachments/assets/6433a7ea-cb18-4714-9a55-7f24c9511839" />
Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.4...0.7.5
URL shortener by @gregpr07 in https://github.com/browser-use/browser-use/pull/2972
user_agent param by @gregpr07 in https://github.com/browser-use/browser-use/pull/2945Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.3...0.7.4
fix-timeouts-long-websites-only-hashmap by @MagMueller in https://github.com/browser-use/browser-use/pull/2963
Full Changelog: https://github.com/browser-use/browser-use/compare/0.7.2...0.7.3
Your coding agent can read these notes before it upgrades. Set up the MCP server →