Shows a black Browser Use Logo in light color mode and a white one in dark color mode.

Enable AI to control your browser

🤖 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-2.5-flash"),
    # 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.

Demos¶

Task: Add grocery items to cart, and checkout.

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

See more examples and give us a star!

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": "your-openai-api-key"
      }
    }
  }
}

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

[![Twitter Follow](https://img.shields.io/twitter/follow/Magnus?style=social)](https://x.com/intent/user?screen_name=mamagnus00) [![Twitter Follow](https://img.shields.io/twitter/follow/Gregor?style=social)](https://x.com/intent/user?screen_name=gregpr07)

Made with ❤️ in Zurich and San Francisco