---

Browser Use CLI 3.0 is here. Give your coding agent a browser it can use reliably.

Paste this into Claude Code, Codex, etc:

Install or upgrade browser-use to the latest stable version with uv using Python 3.12, register the skill from `browser-use skill`, and connect it to my browser. Follow https://github.com/browser-use/browser-use if setup or connection fails.

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

🤖 LLM Quickstart

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

👋 Human Quickstart

1. Install Browser Use (Python>=3.11):

uv add browser-use
# or: pip install browser-use

2. [Optional] Get your API key from Browser Use Cloud:

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

3. Run your first agent:

Python Script:

import asyncio

from browser_use import Agent, BrowserProfile, ChatBrowserUse

async def main():
    agent = Agent(
        task="Find the number of stars of the browser-use repo",
        llm=ChatBrowserUse(model='openai/gpt-5.5'),
        # llm=ChatBrowserUse(model='bu-2-0'),  # Browser Use's own optimized model
        # llm=ChatOpenAI(model='gpt-5.5'),
        # llm=ChatAnthropic(model='claude-opus-4-8'),  # Sonnet also works well.
        browser_profile=BrowserProfile(
            headless=False,
            allowed_domains=["*.github.com"],
        ),
    )
    history = await agent.run()
    print(history.final_result())

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.

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 (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.”

https://github.com/user-attachments/assets/a6813fa7-4a7c-40a6-b4aa-382bf88b1850

Example code ↗

💻 Personal-Assistant.

Task = “Help me find parts for a custom PC.”

https://github.com/user-attachments/assets/ac34f75c-057a-43ef-ad06-5b2c9d42bf06

Example code ↗

💡See more examples here ↗ and give us a star!

🚀 Template Quickstart

Want to get started even faster? Generate a ready-to-run template:

uvx browser-use init --template default

This creates a browser_use_default.py file with a working example. Available templates:

• default - Minimal setup to get started quickly
• advanced - All configuration options with detailed comments
• tools - Examples of custom tools and extending the agent

You can also specify a custom output path:

uvx browser-use init --template default --output my_agent.py

💻 CLI

Browser Use CLI 3.0 lets your agents do work for you online with our highest accuracy yet. It is powered by Browser Harness, and it applies what we learned about agent harnesses and agent frameworks: the latest models do best when you give them freedom, rather than abstracting away complexity. We provide your agents with a direct, dependable surface for acting in the browser.

browser-use <<'PY'
new_tab("https://example.com")
print(page_info())
PY

The CLI allows your agent to control the browser via Python, and it manages the browser in the background.

Agent Skill

For Claude Code, Codex, and other agents, paste this prompt into your agent:

Install or upgrade browser-use to the latest stable version with uv using Python 3.12, register the skill from `browser-use skill`, and connect it to my browser. Follow https://github.com/browser-use/browser-use if setup or connection fails.

Integrations, hosting, custom tools, MCP, and more on our Docs ↗

FAQ