Deutsch | Español | français | 日本語 | 한국어 | Português | Русский | 中文

---

🧈 Butter Fork

This fork includes the following changes:

• Modified message history handling to be append-only
• Added example/butter_caching_example.py to show how to cache with Butter while using Browser Use

For the original project, see upstream repository. The original repository was forked on Oct 21, 2025.

---

🤖 LLM Quickstart

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

👋 Human Quickstart

1. Create environment with uv (Python>=3.11):

uv init

2. Install Browser-Use package:

#  We ship every day - use the latest version!
uv add browser-use
uv sync

3. Get your API key from Browser Use Cloud and add it to your .env file (new signups get $10 free credits):

# .env
BROWSER_USE_API_KEY=your-key

4. Download chromium using playwright's shortcut:

uvx playwright install chromium --with-deps --no-shell

5. Run your first agent:

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

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

grocery-use-large.mp4

Example code ↗

💻 Personal-Assistant.

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

pc-use-large.mp4

Example code ↗

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

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

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

   

Made with ❤️ in Zurich and San Francisco