Release history
browser-use releases
Make websites accessible for AI agents. Automate tasks online with ease.
All releases
22 shown
0.12.6
Bug fix
Fixed O(n²) performance bottleneck in DOM capture for heavy pages.
0.12.5
Security relevant
Breaking changes
- litellm removed from core dependencies — install separately if needed
Security fixes
- Remove litellm dependency in response to supply chain attack (versions 1.82.7 & 1.82.8 backdoored March 24, 2026)
0.12.4
Maintenance
Pinned litellm dependency version and fixed uv installation detection.
0.12.3
New feature
Notable features
- Browser Use CLI 2.0 built on Chrome DevTools Protocol with 50ms latency
- Support for headless, headed, real Chrome profile, and cloud modes
- Advanced interactions: form filling, file uploads, data extraction, JavaScript evaluation
0.12.2
Breaking risk
Breaking changes
- Removed read long content action
Notable features
- Added validation for hard constraints
- Added current date context to judge
- Added strict data grounding rules to prevent hallucination
Full changelog
What's Changed
- don't explicitly pass newWindow: false to CDP createTarget by @laithrw in https://github.com/browser-use/browser-use/pull/4283
- Update documentation links in README.md by @Cheggin in https://github.com/browser-use/browser-use/pull/4308
- Delete docs directory by @Cheggin in https://github.com/browser-use/browser-use/pull/4309
- added check for hard constraints by @sauravpanda in https://github.com/browser-use/browser-use/pull/4318
- fix: detect empty DOM after navigation and retry before reporting failure by @sauravpanda in https://github.com/browser-use/browser-use/pull/4319
- fix: prevent duplicate items in multi-page extraction via already_col… by @sauravpanda in https://github.com/browser-use/browser-use/pull/4320
- Remove free credit mentions from documentation by @sauravpanda in https://github.com/browser-use/browser-use/pull/4322
- fix: add strict data grounding rules to prevent hallucination by @sauravpanda in https://github.com/browser-use/browser-use/pull/4323
- fix: remove incorrect await on synchronous get_llm() by @Bortlesboat in https://github.com/browser-use/browser-use/pull/4305
- improved scrolling instruction for agent by @sauravpanda in https://github.com/browser-use/browser-use/pull/4325
- fix: prevent false success reporting on unresolved blocking error by @sauravpanda in https://github.com/browser-use/browser-use/pull/4324
- added current date to the judge by @sauravpanda in https://github.com/browser-use/browser-use/pull/4332
- Set google genai to 1.65.0. by @sauravpanda in https://github.com/browser-use/browser-use/pull/4339
- remove read long content action by @sauravpanda in https://github.com/browser-use/browser-use/pull/4340
New Contributors
- @Bortlesboat made their first contribution in https://github.com/browser-use/browser-use/pull/4305
Full Changelog: https://github.com/browser-use/browser-use/compare/0.12.1...0.12.2
0.12.0
Maintenance
## What's Changed * improved csv file generation * pin all dependency version in pyproject.toml
0.11.13
New feature
Notable features
- Automatic CAPTCHA solver handling via CAPTCHA watchdog
- WebSocket reconnection for remote browser CDP connections
- PDF export via save_as_pdf agent action
Full changelog
What's Changed
- updated laminar version by @sauravpanda in https://github.com/browser-use/browser-use/pull/4154
- updated _navigate_and_wait by @sauravpanda in https://github.com/browser-use/browser-use/pull/4146
- fix radio button click occlusion when label overlaps input by @sauravpanda in https://github.com/browser-use/browser-use/pull/4157
- feat: added automatic captcha solver handling via CAPTCHA watchdog by @reformedot in https://github.com/browser-use/browser-use/pull/4155
- Add WebSocket reconnection for remote browser CDP connections by @sauravpanda in https://github.com/browser-use/browser-use/pull/4160
- Add timeouts to browser connects and waits by @LarsenCundric in https://github.com/browser-use/browser-use/pull/4204
- Add save_as_pdf agent action for CDP-based page-to-PDF export by @sauravpanda in https://github.com/browser-use/browser-use/pull/4205
- new version 0.11.13 by @sauravpanda in https://github.com/browser-use/browser-use/pull/4207
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.12...0.11.13
0.11.12
Mixed
Notable features
- Browser.from_system_chrome() method for system Chrome automation
- Improved authentication and real browser documentation
- Added Terms of Service and PyPI metadata
Full changelog
What's Changed
- Fix CDP connectivity issues by @LarsenCundric in https://github.com/browser-use/browser-use/pull/4135
- feat: improve auth/real browser docs + add Browser.from_system_chrome() by @laithrw in https://github.com/browser-use/browser-use/pull/3955
- Anthropic model configuration by @MagMueller in https://github.com/browser-use/browser-use/pull/4138
- Browser agent setup by @MagMueller in https://github.com/browser-use/browser-use/pull/4139
- remove simple judge by @sauravpanda in https://github.com/browser-use/browser-use/pull/4144
- Add docs terms of service and PyPI metadata by @MagMueller in https://github.com/browser-use/browser-use/pull/4147
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.11...0.11.12
0.11.11
Mixed
⚠ Upgrade required
- Default consecutive_failures limit increased to 5
- Logging redirected to stderr to prevent MCP stdio interference
Notable features
- Custom headers support for HTTP requests
- File attachments in structured output
- New direct CLI mode
Full changelog
What's Changed
- fix(#3895): stop agent if browser closed by @laithrw in https://github.com/browser-use/browser-use/pull/4056
- fix(llm): handle missing choices in openai proxy response by @sudhanshu112233shukla in https://github.com/browser-use/browser-use/pull/3899
- fix: redirect logging to stderr so MCP stdio doesn't break (#2748) by @laithrw in https://github.com/browser-use/browser-use/pull/4058
- Fix: consecutive_failures counter resetting on multi-action steps by @laithrw in https://github.com/browser-use/browser-use/pull/4059
- Fix: Improve sensitive data replacement when LLM omits tags by @mo1998 in https://github.com/browser-use/browser-use/pull/3971
- fix: improve sensitive_data placeholder instructions for LLM clarity by @ashish-cheruku in https://github.com/browser-use/browser-use/pull/4048
- Fixed structured output issue with simple judge by @sauravpanda in https://github.com/browser-use/browser-use/pull/4064
- fix: remove double-counting of reasoning_tokens in OpenAI usage by @Chase-Xuu in https://github.com/browser-use/browser-use/pull/4075
- increase default consecutive failure to 5 by @sauravpanda in https://github.com/browser-use/browser-use/pull/4080
- fix: retry select_dropdown when options are lazily populated by @sauravpanda in https://github.com/browser-use/browser-use/pull/4084
- better installation and more cli features by @ShawnPana in https://github.com/browser-use/browser-use/pull/4078
- feat(install): always install from GitHub main branch by @ShawnPana in https://github.com/browser-use/browser-use/pull/4092
- preview release by @sauravpanda in https://github.com/browser-use/browser-use/pull/4093
- Fix download monitoring issues with fetch requests and blob downloads by @sandeepsalwan1 in https://github.com/browser-use/browser-use/pull/3518
- Agent max clickable parameter by @MagMueller in https://github.com/browser-use/browser-use/pull/4107
- fix(#3791) keep-alive hang by @laithrw in https://github.com/browser-use/browser-use/pull/4112
- Action name unbound error by @MagMueller in https://github.com/browser-use/browser-use/pull/4114
- Agent event output truncation by @MagMueller in https://github.com/browser-use/browser-use/pull/4113
- added cookie overlay fix by @sauravpanda in https://github.com/browser-use/browser-use/pull/4111
- feat: add custom headers support + add example by @reformedot in https://github.com/browser-use/browser-use/pull/4118
- update SKILL.md files by @ShawnPana in https://github.com/browser-use/browser-use/pull/4122
- add file attachments to structured output. by @sauravpanda in https://github.com/browser-use/browser-use/pull/4123
- new direct cli mode by @sauravpanda in https://github.com/browser-use/browser-use/pull/4124
- Update pyproject.toml by @sauravpanda in https://github.com/browser-use/browser-use/pull/4125
New Contributors
- @mo1998 made their first contribution in https://github.com/browser-use/browser-use/pull/3971
- @ashish-cheruku made their first contribution in https://github.com/browser-use/browser-use/pull/4048
- @Chase-Xuu made their first contribution in https://github.com/browser-use/browser-use/pull/4075
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.9...0.11.11
0.11.10a2
Bug fix
Fixed download monitoring issues with fetch requests and blob downloads.
0.11.10a1
Bug fix
Stability improvements for agent execution, LLM integration, and error handling.
0.11.9
Mixed
⚠ Upgrade required
- Default max step updated to 500
- Increased threshold for action loop detection
Notable features
- read_long_content action for processing long webpages and files
- Improved action loop detection with increased thresholds
- HarRecordingWatchdog for HTTPS HAR capture
Full changelog
What's Changed
- added basic planing to agents by @sauravpanda in https://github.com/browser-use/browser-use/pull/4008
- align agent success with simple judge by @sauravpanda in https://github.com/browser-use/browser-use/pull/4009
- updated agent success with simple judge by @sauravpanda in https://github.com/browser-use/browser-use/pull/4014
- fix(#3619): add hidden content hints for iframes in DOM context by @laithrw in https://github.com/browser-use/browser-use/pull/3941
- feat: read_long_content action for long webpages and files by @laithrw in https://github.com/browser-use/browser-use/pull/3994
- Action Loop detection by @sauravpanda in https://github.com/browser-use/browser-use/pull/4027
- improve text field handling by @sauravpanda in https://github.com/browser-use/browser-use/pull/4023
- increased threshold for loop detection by @sauravpanda in https://github.com/browser-use/browser-use/pull/4033
- Add HarRecordingWatchdog for HTTPS HAR capture by @kalil0321 in https://github.com/browser-use/browser-use/pull/3543
- fix(#3657): agent not switching tabs after new opened by @laithrw in https://github.com/browser-use/browser-use/pull/4034
- fix: correct docker build context path in build-base-images.sh by @shobhitsahani in https://github.com/browser-use/browser-use/pull/4018
- updated default max step to 500 by @sauravpanda in https://github.com/browser-use/browser-use/pull/4040
- added milder nudge for action loop by @sauravpanda in https://github.com/browser-use/browser-use/pull/4039
- added message compaction for agent by @sauravpanda in https://github.com/browser-use/browser-use/pull/4042
- fix: hide StructuredOutputAction.success from LLM schema to prevent field name collisions by @laithrw in https://github.com/browser-use/browser-use/pull/4044
- Update pyproject.toml by @sauravpanda in https://github.com/browser-use/browser-use/pull/4045
New Contributors
- @shobhitsahani made their first contribution in https://github.com/browser-use/browser-use/pull/4018
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.8...0.11.9
0.11.7
Breaking risk
Breaking changes
- --cdp-url CLI flag has been removed
Notable features
- grep tool added to agent
Full changelog
What's Changed
- add grep tool to agent by @sauravpanda in https://github.com/browser-use/browser-use/pull/3997
- Revert "feat(cli): add --cdp-url flag to connect to existing browser … by @sauravpanda in https://github.com/browser-use/browser-use/pull/3998
- improved filename sanitization by @sauravpanda in https://github.com/browser-use/browser-use/pull/3985
- fix: restore install, init, --mcp commands in skill_cli by @gregpr07 in https://github.com/browser-use/browser-use/pull/3999
- 0.11.7 release by @gregpr07 in https://github.com/browser-use/browser-use/pull/4001
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.6...0.11.7
0.11.6
Breaking risk
⚠ Upgrade required
- LLM timeout increased to 75 seconds for Gemini and browser-use models
- Default step_timeout increased from 120 to 180 seconds
- MAX_MEMORY_LENGTH increased from 1000 to 10000 characters
Breaking changes
- Special Anthropic prompts removed unless using the flash model
Notable features
- CLI: --cdp-url flag to connect to existing browser via Chrome DevTools Protocol
- Wait for file download action in browser automation
- Handle autocomplete fields in form interactions
Full changelog
What's Changed
- fix(#3264): clear agent eventbus, not just browser session's by @laithrw in https://github.com/browser-use/browser-use/pull/3964
- Increase LLM timeout to 75s for gemini and browser-use models by @MagMueller in https://github.com/browser-use/browser-use/pull/3966
- Increase default step_timeout from 120s to 180s by @MagMueller in https://github.com/browser-use/browser-use/pull/3967
- docs(skill): add installation and API key configuration to SKILL.md by @gregpr07 in https://github.com/browser-use/browser-use/pull/3962
- feat(cli): add --cdp-url flag to connect to existing browser via CDP by @iammarcin in https://github.com/browser-use/browser-use/pull/3927
- switched to bu-2-0 in all the examples by @sauravpanda in https://github.com/browser-use/browser-use/pull/3974
- handle autocomplete fields by @sauravpanda in https://github.com/browser-use/browser-use/pull/3980
- Increase MAX_MEMORY_LENGTH from 1000 to 10000 chars by @MagMueller in https://github.com/browser-use/browser-use/pull/3977
- fix: validate file size on upload and dynamic text extension list by @MagMueller in https://github.com/browser-use/browser-use/pull/3976
- add step budget awareness to prompt by @sauravpanda in https://github.com/browser-use/browser-use/pull/3981
- fix(filesystem): improve write_file filename handling and error messages by @MagMueller in https://github.com/browser-use/browser-use/pull/3975
- Backport prompt improvements from anthropic variants to standard prompts by @sauravpanda in https://github.com/browser-use/browser-use/pull/3982
- added optional file_name param to ss action by @laithrw in https://github.com/browser-use/browser-use/pull/3989
- rm special anthropic prompts unless flash by @laithrw in https://github.com/browser-use/browser-use/pull/3991
- generalize leaf start fix by @laithrw in https://github.com/browser-use/browser-use/pull/3963
- Feat: wait for file download action by @laithrw in https://github.com/browser-use/browser-use/pull/3984
- bumping to 0.11.6 by @sauravpanda in https://github.com/browser-use/browser-use/pull/3995
New Contributors
- @iammarcin made their first contribution in https://github.com/browser-use/browser-use/pull/3927
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.5...0.11.6
0.11.5
Breaking risk
⚠ Upgrade required
- BROWSER_USE_API_KEY environment variable required for bu-2-0 model integration
- Gemini model thinking defaults changed: disabled (0) for gemini-3 models, auto for others
Notable features
- bu-2-0 model achieving 83.3% accuracy (+12% improvement over bu-1-0) while maintaining ~60s/task speed
- ChatBrowserUse class with BROWSER_USE_API_KEY environment variable support for model selection
Full changelog
Release: 0.11.5 - Browser Use Model bu-2-0 🚀
We're excited to announce bu-2-0, our latest premium model for browser automation.
What's New
bu-2-0 delivers a significant leap in accuracy while maintaining the speed that made bu-1-0 the fastest web agent:
Metric | bu-1-0 | bu-2-0
-- | -- | --
Accuracy | 74.7% | 83.3% (+12%)
Speed | 58s/task | 60s/task (≈ same)
Quick Start
from browser_use import Agent, ChatBrowserUse
llm = ChatBrowserUse(model='bu-2-0')
agent = Agent(
task="Your task here",
llm=llm
)
await agent.run()
Environment Setup
export BROWSER_USE_API_KEY=your_api_key_here
Get your API key at cloud.browser-use.com
What's Changed
- Added support for new browser use model by @sauravpanda in https://github.com/browser-use/browser-use/pull/3920
- Added browser use 2-0 support by @sauravpanda in https://github.com/browser-use/browser-use/pull/3921
- set default thinking to 0 for gemini-3 models by @sauravpanda in https://github.com/browser-use/browser-use/pull/3922
- feat(cli): add ChatBrowserUse support for BROWSER_USE_API_KEY by @BouquetAntoine in https://github.com/browser-use/browser-use/pull/3914
- feat: added thinking level for gemini 3 pro by @sauravpanda in https://github.com/browser-use/browser-use/pull/3925
- increase char limit for extraction by @laithrw in https://github.com/browser-use/browser-use/pull/3923
- 4096-token prompts for Opus/Haiku 4.5 by @laithrw in https://github.com/browser-use/browser-use/pull/3924
- detect JS event listeners for clickable elements (resolves #958) by @laithrw in https://github.com/browser-use/browser-use/pull/3933
- fix: detect label/span wrappers for AntD-style controls by @ditingdapeng in https://github.com/browser-use/browser-use/pull/3854
- fix(#3292): make table rows and cells with role='row'/'cell' interactive by @sudhanshu112233shukla in https://github.com/browser-use/browser-use/pull/3870
- removed duplicate --headed flag from skill cli by @sauravpanda in https://github.com/browser-use/browser-use/pull/3943
- fix(#2867): verify dropdown selection and retry on framework revert by @laithrw in https://github.com/browser-use/browser-use/pull/3944
- fix(#3538): always index scrollable dropdown containers by @laithrw in https://github.com/browser-use/browser-use/pull/3945
- issue 3694 fixed: handling aria combobox options dropdown by @AbhinavMalkoochi in https://github.com/browser-use/browser-use/pull/3698
- set default gemini thinking to auto by @sauravpanda in https://github.com/browser-use/browser-use/pull/3950
- fix(#3889): Draft.js editors lose first character when typing by @laithrw in https://github.com/browser-use/browser-use/pull/3952
- fix(#3889): Draft.js editors lose first character when typing by @Jacky040124 in https://github.com/browser-use/browser-use/pull/3896
- feat: add bu-2-0 pricing by @sauravpanda in https://github.com/browser-use/browser-use/pull/3956
- added bu 2-0 pricing to docs by @sauravpanda in https://github.com/browser-use/browser-use/pull/3958
- Fix/respect use vision in judge fix by @laithrw in https://github.com/browser-use/browser-use/pull/3957
- update browser use version by @sauravpanda in https://github.com/browser-use/browser-use/pull/3960
New Contributors
- @BouquetAntoine made their first contribution in https://github.com/browser-use/browser-use/pull/3914
- @laithrw made their first contribution in https://github.com/browser-use/browser-use/pull/3923
- @ditingdapeng made their first contribution in https://github.com/browser-use/browser-use/pull/3854
- @sudhanshu112233shukla made their first contribution in https://github.com/browser-use/browser-use/pull/3870
- @Jacky040124 made their first contribution in https://github.com/browser-use/browser-use/pull/3896
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.4...0.11.5
0.11.4
New feature
Notable features
- Browser Use CLI for local and remote browser automation
- Claude Code skill integration with element-based indexing
- Multiple browser modes: headless, headed, real Chrome, and cloud
0.11.3
Breaking risk
⚠ Upgrade required
- New environment variable BROWSER_USE_DISABLE_EXTENSIONS to disable extensions
- Event bus timeout now configurable via environment variables
Breaking changes
- Search removed from v1 API
Notable features
- Added support for OpenAI responses model
- Added support for Gemini 3 Flash preview model
- Added support for multi-tab video recording
Full changelog
What's Changed
- Bu_oss example flash mode by @mertunsall in https://github.com/browser-use/browser-use/pull/3774
- include ax_name for rerun history element hash by @sauravpanda in https://github.com/browser-use/browser-use/pull/3775
- Dont skip failrues by default by @mertunsall in https://github.com/browser-use/browser-use/pull/3777
- fix: Cascading element matching for history rerun stability by @mertunsall in https://github.com/browser-use/browser-use/pull/3781
- feat: added Unique attribute match and better error logging for rerun by @sauravpanda in https://github.com/browser-use/browser-use/pull/3783
- Fix glob pattern for Playwright browser paths by @stevbev in https://github.com/browser-use/browser-use/pull/3778
- added BROWSER_USE_DISABLE_EXTENSIONS env var to disable extension by @sauravpanda in https://github.com/browser-use/browser-use/pull/3784
- added gemini 3 flash preview model by @sauravpanda in https://github.com/browser-use/browser-use/pull/3785
- fix: change max_step_interval to 45s by @sauravpanda in https://github.com/browser-use/browser-use/pull/3788
- Simplify Sandbox Structured Output Example by @mertunsall in https://github.com/browser-use/browser-use/pull/3789
- add support for external skillservice by @sauravpanda in https://github.com/browser-use/browser-use/pull/3790
- fetch all skills available for agent by @sauravpanda in https://github.com/browser-use/browser-use/pull/3792
- fix: include shadow DOM form elements in selector_map even without sn… by @sauravpanda in https://github.com/browser-use/browser-use/pull/3793
- fix: expose prohibited_domains in BrowserSession by @akramcodez in https://github.com/browser-use/browser-use/pull/3770
- fix: use correct MIME type for images in Google serializer by @sauravpanda in https://github.com/browser-use/browser-use/pull/3798
- fix: resolve Gemini API error on empty action schemas by @nitesh-77 in https://github.com/browser-use/browser-use/pull/3804
- feat: remove redundant retry step from history by @sauravpanda in https://github.com/browser-use/browser-use/pull/3807
- feat: add support for openai responses model by @sauravpanda in https://github.com/browser-use/browser-use/pull/3805
- feat: added exp backoff retry and minimum element load by @sauravpanda in https://github.com/browser-use/browser-use/pull/3808
- refactor: Replace print with logger.debug in actor/page.py by @constx1337 in https://github.com/browser-use/browser-use/pull/3814
- Remove search from v1 by @LarsenCundric in https://github.com/browser-use/browser-use/pull/3834
- fixed broken links in docs by @sauravpanda in https://github.com/browser-use/browser-use/pull/3841
- docs: add missing video recording dependency notice by @sauravpanda in https://github.com/browser-use/browser-use/pull/3842
- Added ax-name fallback for history rerun. by @sauravpanda in https://github.com/browser-use/browser-use/pull/3849
- Add support for multi-tab video recording by @EnzoFanAccount in https://github.com/browser-use/browser-use/pull/3728
- fix-scroll-action by @MagMueller in https://github.com/browser-use/browser-use/pull/3869
- make event bus timeout configurable using env by @sauravpanda in https://github.com/browser-use/browser-use/pull/3893
- Added docs for timeout env variables. by @sauravpanda in https://github.com/browser-use/browser-use/pull/3894
- Add menu retry for agent rerun if fails by @sauravpanda in https://github.com/browser-use/browser-use/pull/3891
- fix: updated aiohttp version by @sauravpanda in https://github.com/browser-use/browser-use/pull/3901
New Contributors
- @stevbev made their first contribution in https://github.com/browser-use/browser-use/pull/3778
- @nitesh-77 made their first contribution in https://github.com/browser-use/browser-use/pull/3804
- @constx1337 made their first contribution in https://github.com/browser-use/browser-use/pull/3814
Full Changelog: https://github.com/browser-use/browser-use/compare/0.11.2...0.11.3