🌤️ Want to skip the setup? Use our cloud for faster, scalable, stealth-enabled browser automation!

🤖 LLM Quickstart

1. 1.Direct your favorite coding agent (Cursor, Claude Code, etc) to Agents.md
2. 2.Prompt away!

👋 Human Quickstart

1. Create environment and install Browser-Use with [uv](https://docs.astral.sh/uv/) (Python>=3.11):

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?utm_source=github&utm_medium=readme):

# .env
BROWSER_USE_API_KEY=your-key
# GOOGLE_API_KEY=your-key
# ANTHROPIC_API_KEY=your-key

3. Run your first agent:

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 and the cloud docs for more!

Open Source vs Cloud

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 the Open-Source Agent

• You need custom tools or deep code-level integration
• We recommend pairing with our cloud browsers for leading stealth, proxy rotation, and scaling
• Or self-host the open-source agent fully on your own machines

Use the [Fully-Hosted Cloud Agent](https://cloud.browser-use.com?utm_source=github&utm_medium=readme) (recommended)

• Much more powerful 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, and more)
• Persistent filesystem and memory

Demos

📋 Form-Filling

#### Task = "Fill in this job application with my resume and information."

Example code ↗

🍎 Grocery-Shopping

#### Task = "Put this list of items into my instacart."