# browser-use

> Make websites accessible for AI agents

- **URL**: https://www.freshcrate.ai/projects/browser-use
- **Author**: Gregor Zunic
- **Category**: Databases
- **Latest version**: `0.12.9` (2026-05-26)
- **License**: Unknown
- **Source**: https://github.com/browser-use/browser-use
- **Homepage**: https://pypi.org/project/browser-use/
- **Language**: Python
- **GitHub**: 89,240 stars, 10,204 forks
- **Registry**: pypi (`browser-use`)
- **Tags**: `pypi`

## Description

<picture>
  <source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/2ccdb752-22fb-41c7-8948-857fc1ad7e24"">
  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/774a46d5-27a0-490c-b7d0-e65fcbbfa358">
  <img alt="Shows a black Browser Use Logo in light color mode and a white one in dark color mode." src="https://github.com/user-attachments/assets/2ccdb752-22fb-41c7-8948-857fc1ad7e24"  width="full">
</picture>

<div align="center">
    <picture>
    <source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/9955dda9-ede3-4971-8ee0-91cbc3850125"">
    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/6797d09b-8ac3-4cb9-ba07-b289e080765a">
    <img alt="The AI browser agent." src="https://github.com/user-attachments/assets/9955dda9-ede3-4971-8ee0-91cbc3850125"  width="400">
    </picture>
</div>

<div align="center">
<a href="https://cloud.browser-use.com"><img src="https://media.browser-use.tools/badges/package" height="48" alt="Browser-Use Package Download Statistics"></a>
</div>

---

<div align="center">
<a href="#demos"><img src="https://media.browser-use.tools/badges/demos" alt="Demos"></a>
<img width="16" height="1" alt="">
<a href="https://docs.browser-use.com"><img src="https://media.browser-use.tools/badges/docs" alt="Docs"></a>
<img width="16" height="1" alt="">
<a href="https://browser-use.com/posts"><img src="https://media.browser-use.tools/badges/blog" alt="Blog"></a>
<img width="16" height="1" alt="">
<a href="https://browsermerch.com"><img src="https://media.browser-use.tools/badges/merch" alt="Merch"></a>
<img width="100" height="1" alt="">
<a href="https://github.com/browser-use/browser-use"><img src="https://media.browser-use.tools/badges/github" alt="Github Stars"></a>
<img width="4" height="1" alt="">
<a href="https://x.com/intent/user?screen_name=browser_use"><img src="https://media.browser-use.tools/badges/twitter" alt="Twitter"></a>
<img width="4 height="1" alt="">
<a href="https://link.browser-use.com/discord"><img src="https://media.browser-use.tools/badges/discord" alt="Discord"></a>
<img width="4" height="1" alt="">
<a href="https://cloud.browser-use.com"><img src="https://media.browser-use.tools/badges/cloud" height="48" alt="Browser-Use Cloud"></a>
</div>

</br>

🌤️ Want to skip the setup? Use our <b>[cloud](https://cloud.browser-use.com)</b> for faster, scalable, stealth-enabled browser automation!

# 🤖 LLM Quickstart

1. Direct your favorite coding agent (Cursor, Claude Code, etc) to [Agents.md](https://docs.browser-use.com/llms-full.txt)
2. Prompt away!

<br/>

# 👋 Human Quickstart

**1. Create environment and install Browser-Use with [uv](https://docs.astral.sh/uv/) (Python>=3.11):**
```bash
uv init && uv add browser-use && uv sync
# uvx browser-use install  # Run if you don't have Chromium installed
```

**2. [Optional] Get your API key from [Browser Use Cloud](https://cloud.browser-use.com/new-api-key):**
```
# .env
BROWSER_USE_API_KEY=your-key
# GOOGLE_API_KEY=your-key
# ANTHROPIC_API_KEY=your-key
```

**3. Run your first agent:**
```python
from browser_use import Agent, Browser, ChatBrowserUse
# from browser_use import ChatGoogle  # ChatGoogle(model='gemini-3-flash-preview')
# from browser_use import ChatAnthropic  # ChatAnthropic(model='claude-sonnet-4-6')
import asyncio

async def main():
    browser = Browser(
        # use_cloud=True,  # Use a stealth browser on Browser Use Cloud
    )

    agent = Agent(
        task="Find the number of stars of the browser-use repo",
        llm=ChatBrowserUse(),
        # llm=ChatGoogle(model='gemini-3-flash-preview'),
        # llm=ChatAnthropic(model='claude-sonnet-4-6'),
        browser=browser,
    )
    await agent.run()

if __name__ == "__main__":
    asyncio.run(main())
```

Check out the [library docs](https://docs.browser-use.com/open-source/introduction) and the [cloud docs](https://docs.cloud.browser-use.com) for more!

<br/>

# Open Source vs Cloud

<picture>
  <source media="(prefers-color-scheme: light)" srcset="static/accuracy_by_model_light.png">
  <source media="(prefers-color-scheme: dark)" srcset="static/accuracy_by_model_dark.png">
  <img alt="BU Bench V1 - LLM Success Rates" src="static/accuracy_by_model_light.png" width="100%">
</picture>

We benchmark Browser Use across 100 real-world browser tasks. Full benchmark is open source: **[browser-use/benchmark](https://github.com/browser-use/benchmark)**.

**Use Open Source**
- You need [custom tools](https://docs.browser-use.com/customize/tools/basics) or deep code-level integration
- You want to self-host and deploy browser agents on your own machines

**Use [Cloud](https://cloud.browser-use.com) (recommended)**
- Much better agent for complex tasks (see plot above)
- Easiest way to start and scale
- Best stealth with proxy rotation and captcha solving
- 1000+ integrations (Gmail, Slack, Notion,

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `0.12.9` | 2026-05-26 | High | ## What's Changed * Pass session id to judge LLM calls by @MagMueller in https://github.com/browser-use/browser-use/pull/4918 * fix(agent): skip screenshots on new tab pages by @MagMueller in https://github.com/browser-use/browser-use/pull/4920   **Full Changelog**: https://github.com/browser-use/browser-use/compare/0.12.8...0.12.9 |
| `0.12.8` | 2026-05-23 | High | ## What's Changed * fix(daemon): restrict unix socket file to owner-only access by @sauravpanda in https://github.com/browser-use/browser-use/pull/4870 * docs: clarify integration example placement by @felix-windsor in https://github.com/browser-use/browser-use/pull/4856 * fix(tools): refuse evaluate() on restricted browser profiles by @sauravpanda in https://github.com/browser-use/browser-use/pull/4871 * chore(llm): default ChatBrowserUse to bu-2-0 by @sauravpanda in https://github.com/brow |
| `0.12.7` | 2026-05-19 | High | ## What's Changed * another big cli update by @ShawnPana in https://github.com/browser-use/browser-use/pull/4514 * fix: security and correctness issues found in #4514 review by @sauravpanda in https://github.com/browser-use/browser-use/pull/4590 * fix: upgrade aiohttp to 3.13.4 to patch memory exhaustion vulnerability by @sauravpanda in https://github.com/browser-use/browser-use/pull/4596 * fix: upgrade requests to 2.33.0 to patch temp-file path-traversal vulnerability by @sauravpanda in htt |
| `0.12.6` | 2026-04-21 | Low | Imported from PyPI (0.12.6) |
| `0.12.5` | 2026-03-25 | Medium | ## Security fix  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 litellm - `ChatLiteLLM` wrapper is preserved — install litellm separately if needed: `pip install litellm`  See: https://github.com/browser-use/browser-use/pull/4515 |
| `0.12.4` | 2026-03-24 | Medium | Pinned litellm library version ------ ## What's Changed * fix: detect uv installed via curl script by @ishan0102 in https://github.com/browser-use/browser-use/pull/4478 * frozen litellm version by @sauravpanda in https://github.com/browser-use/browser-use/pull/4509 * Update pyproject.toml by @sauravpanda in https://github.com/browser-use/browser-use/pull/4511  ## New Contributors * @ishan0102 made their first contribution in https://github.com/browser-use/browser-use/pull/4478  **Full |
| `0.12.3` | 2026-03-23 | Medium | ## Browser Use CLI 2.0  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  ```bash # Install the CLI curl -fsSL https://browser-use.com/cli/install.sh \| bash  # In |
| `0.12.2` | 2026-03-12 | Low | ## 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 navigatio |
| `0.12.1` | 2026-03-03 | Low | ## What's Changed * Fix proxy auth attach handler overwriting tab tracking by @laithrw in https://github.com/browser-use/browser-use/pull/4220 * fix(#3523): storage_state restore (cookies + localStorage) by @laithrw in https://github.com/browser-use/browser-use/pull/4102 * patched gemini version by @sauravpanda in https://github.com/browser-use/browser-use/pull/4234 * Docs primary colors by @lukasec in https://github.com/browser-use/browser-use/pull/4244 * added product hunt launch banner b |
| `0.12.0` | 2026-02-26 | Low | ## What's Changed * improved csv file generation by @sauravpanda in https://github.com/browser-use/browser-use/pull/4213 * pin all dependency version in pyproject.toml by @sauravpanda in https://github.com/browser-use/browser-use/pull/4215   **Full Changelog**: https://github.com/browser-use/browser-use/compare/0.11.13...0.12.0 |

## Citation

- HTML: https://www.freshcrate.ai/projects/browser-use
- Markdown: https://www.freshcrate.ai/projects/browser-use.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/browser-use/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._