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: 30 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 with [uv](https://docs.astral.sh/uv/) (Python>=3.11):**

```bash

uv init

```



**2. Install Browser-Use package:**

```bash

#  We ship every day - use the latest version!

uv add browser-use

uv sync

```



**3. Get your API key from [Browser Use Cloud](https://cloud.browser-use.com/new-api-key) and add it to your `.env` file (new signups get $10 free credits):**

```

# .env

BROWSER_USE_API_KEY=your-key

```



**4. Install Chromium browser:**

```bash

uvx browser-use install

```



**5. Run your first agent:**

```python

from browser_use import Agent, Browser, ChatBrowserUse

import asyncio



async def example():

    browser = Browser(

        # use_cloud=True,  # Uncomment to use a stealth browser on Browser Use Cloud

    )



    llm = ChatBrowserUse()



    agent = Agent(

        task="Find the number of stars of the browser-use repo",

        llm=llm,

        browser=browser,

    )



    history = await agent.run()

    return history



if __name__ == "__main__":

    history = asyncio.run(example())

```



Check out the [library docs](https://docs.browser-use.com) and the [cloud docs](https://docs.cloud.browser-use.com) for more!







# πŸ”₯ Deploy on Sandboxes



We handle agents, browsers, persistence, auth, cookies, and LLMs. The agent runs right next to the browser for minimal latency.



```python

from browser_use import Browser, sandbox, ChatBrowserUse

from browser_use.agent.service import Agent

import asyncio



@sandbox()

async def my_task(browser: Browser):

    agent = Agent(task="Find the top HN post", browser=browser, llm=ChatBrowserUse())

    await agent.run()



# Just call it like any async function

asyncio.run(my_task())

```



See [Going to Production](https://docs.browser-use.com/production) for more details.







# πŸš€ 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

```







# 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!







## 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).



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).



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