Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/browser-use/browser-use

🌐 Make websites accessible for AI agents. Automate tasks online with ease.
https://github.com/browser-use/browser-use

ai-agents ai-tools browser-automation browser-use llm playwright python

Last synced: 10 days ago
JSON representation

🌐 Make websites accessible for AI agents. Automate tasks online with ease.

Awesome Lists containing this project

README 

          

  

  

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





    

    

    

    The AI browser agent.

    






Browser-Use Package Download Statistics




---





Demos



Docs



Blog



Merch



Github Stars



Twitter



Discord



Browser-Use Cloud




🌀️ Want to skip the setup? Use our [cloud](https://cloud.browser-use.com) 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!







# πŸ‘‹ 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!







# Open Source vs Cloud



  

  

  BU Bench V1 - LLM Success Rates



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, and more)

- Persistent filesystem and memory



**Use Both**

- Use the open-source library with your [custom tools](https://docs.browser-use.com/customize/tools/basics) while running our [cloud browsers](https://docs.browser-use.com/open-source/customize/browser/remote) and [ChatBrowserUse model](https://docs.browser-use.com/open-source/supported-models)







# Demos



### πŸ“‹ Form-Filling

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

![Job Application Demo](https://github.com/user-attachments/assets/57865ee6-6004-49d5-b2c2-6dff39ec2ba9)

[Example code β†—](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/apply_to_job.py)



### 🍎 Grocery-Shopping

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



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



[Example code β†—](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/buy_groceries.py)



### πŸ’» Personal-Assistant.

#### Task = "Help me find parts for a custom PC."



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



[Example code β†—](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/pcpartpicker.py)



### πŸ’‘See [more examples here β†—](https://docs.browser-use.com/examples) and give us a star!







# πŸš€ Template Quickstart



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



```bash

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:

```bash

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

```







# πŸ’» CLI



Fast, persistent browser automation from the command line:



```bash

browser-use open https://example.com    # Navigate to URL

browser-use state                       # See clickable elements

browser-use click 5                     # Click element by index

browser-use type "Hello"                # Type text

browser-use screenshot page.png         # Take screenshot

browser-use close                       # Close browser

```



The CLI keeps the browser running between commands for fast iteration. See [CLI docs](browser_use/skill_cli/README.md) for all commands.



### Claude Code Skill



For [Claude Code](https://claude.ai/code), install the skill to enable AI-assisted browser automation:



```bash

mkdir -p ~/.claude/skills/browser-use

curl -o ~/.claude/skills/browser-use/SKILL.md \

  https://raw.githubusercontent.com/browser-use/browser-use/main/skills/browser-use/SKILL.md

```







## Integrations, hosting, custom tools, MCP, and more on our [Docs β†—](https://docs.browser-use.com)







# FAQ



What's the best model to use?



We optimized **ChatBrowserUse()** specifically for browser automation tasks. On avg it completes tasks 3-5x faster than other models with SOTA accuracy.



**Pricing (per 1M tokens):**

- Input tokens: $0.20

- Cached input tokens: $0.02

- Output tokens: $2.00



For other LLM providers, see our [supported models documentation](https://docs.browser-use.com/supported-models).



Should I use the Browser Use system prompt with the open-source preview model?



Yes. If you use `ChatBrowserUse(model='browser-use/bu-30b-a3b-preview')` with a normal `Agent(...)`, Browser Use still sends its default agent system prompt for you.



You do **not** need to add a separate custom "Browser Use system message" just because you switched to the open-source preview model. Only use `extend_system_message` or `override_system_message` when you intentionally want to customize the default behavior for your task.



If you want the best default speed/accuracy, we still recommend the newer hosted `bu-*` models. If you want the open-source preview model, the setup stays the same apart from the `model=` value.



Can I use custom tools with the agent?



Yes! You can add custom tools to extend the agent's capabilities:



```python

from browser_use import Tools



tools = Tools()



@tools.action(description='Description of what this tool does.')

def custom_tool(param: str) -> str:

    return f"Result: {param}"



agent = Agent(

    task="Your task",

    llm=llm,

    browser=browser,

    tools=tools,

)

```



Can I use this for free?



Yes! Browser-Use is open source and free to use. You only need to choose an LLM provider (like OpenAI, Google, ChatBrowserUse, or run local models with Ollama).



Terms of Service



This open-source library is licensed under the MIT License. For Browser Use services & data policy, see our [Terms of Service](https://browser-use.com/legal/terms-of-service) and [Privacy Policy](https://browser-use.com/privacy/).



How do I handle authentication?



Check out our authentication examples:

- [Using real browser profiles](https://github.com/browser-use/browser-use/blob/main/examples/browser/real_browser.py) - Reuse your existing Chrome profile with saved logins

- If you want to use temporary accounts with inbox, choose AgentMail

- To sync your auth profile with the remote browser, run `curl -fsSL https://browser-use.com/profile.sh | BROWSER_USE_API_KEY=XXXX sh` (replace XXXX with your API key)



These examples show how to maintain sessions and handle authentication seamlessly.



How do I solve CAPTCHAs?



For CAPTCHA handling, you need better browser fingerprinting and proxies. Use [Browser Use Cloud](https://cloud.browser-use.com) which provides stealth browsers designed to avoid detection and CAPTCHA challenges.



How do I go into production?



Chrome can consume a lot of memory, and running many agents in parallel can be tricky to manage.



For production use cases, use our [Browser Use Cloud API](https://cloud.browser-use.com) which handles:

- Scalable browser infrastructure

- Memory management

- Proxy rotation

- Stealth browser fingerprinting

- High-performance parallel execution










**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