<picture> <source media="(prefers-color-scheme: dark)" srcset="./static/browser-use-dark.png"> <source media="(prefers-color-scheme: light)" srcset="./static/browser-use.png"> <img alt="Shows a black Browser Use Logo in light color mode and a white one in dark color mode." src="./static/browser-use.png" width="full"> </picture>

<h1 align="center">Enable AI to control your browser</h1>

<!-- Keep these links. Translations will automatically update with the README. --> Deutsch | Español | français | 日本語 | 한국어 | Português | Русский | 中文

🤖 Quickstart

With uv (Python>=3.11):

#  We ship every day - use the latest version!
uv pip install browser-use

Download chromium using playwright's shortcut:

uvx playwright install chromium --with-deps --no-shell

Create a .env file and add your API key. Don't have one? Start with a free Gemini key.

GEMINI_API_KEY=

Run your first agent:

from browser_use import Agent, ChatGoogle
from dotenv import load_dotenv
load_dotenv()

agent = Agent(
    task="Find the number of stars of the browser-use repo",
    llm=ChatGoogle(model="gemini-flash-latest"),
    # browser=Browser(use_cloud=True),  # Uses Browser-Use cloud for the browser
)
agent.run_sync()

Check out the library docs and cloud docs for more settings.

Stealth Browser Infrastructure

Want to bypass Cloudflare, or any other anti-bot protection?

Simply go to Browser Use Cloud grab a BROWSER_USE_API_KEY and use the use_cloud parameter.

from browser_use import Agent, Browser, ChatOpenAI

# Use Browser-Use cloud browser service
browser = Browser(
    use_cloud=True,  # Automatically provisions a cloud browser
)

agent = Agent(
    task="Your task here",
    llm=ChatOpenAI(model='gpt-4.1-mini'),
    browser=browser,
)

Demos

Task: Add grocery items to cart, and checkout.

<br/><br/>

Task: Read my CV & find ML jobs, save them to a file, and then start applying for them in new tabs, if you need help, ask me.

https://github.com/user-attachments/assets/171fb4d6-0355-46f2-863e-edb04a828d04

<br/><br/>

See more examples and give us a star!

<br/><br/>

MCP Integration

This gives Claude Desktop access to browser automation tools for web scraping, form filling, and more. See the MCP docs.

{
  "mcpServers": {
    "browser-use": {
      "command": "uvx",
      "args": ["browser-use[cli]", "--mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

<div align="center">

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

<img src="https://github.com/user-attachments/assets/06fa3078-8461-4560-b434-445510c1766f" width="400"/>

</div>

<div align="center"> Made with ❤️ in Zurich and San Francisco </div>