mirror of
https://github.com/browser-use/browser-use.git
synced 2026-09-14 19:59:47 +08:00
feature/colored-dom-highlights
🤖 LLM Quickstart
- Direct your favorite coding agent (Cursor, ClaudeS, etc) to Agents.md
- Prompt away!
👋 Human Quickstart
1. Create environment with uv (Python>=3.11):
uv venv --python 3.12
source .venv/bin/activate
2. Install Browser-Use package:
# We ship every day - use the latest version!
uv pip install browser-use
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, ChatBrowserUse
agent = Agent(
task="Find the number of stars of the browser-use repo",
llm=ChatBrowserUse(),
)
agent.run_sync()
Check out the library docs for more!
Stealth Browser Infrastructure
Want to bypass anti-bot detection or run a fleet of agents on the cloud? Use our hosted stealth browsers.
Follow steps 1-3 above, and pass in a Browser made with the use_cloud parameter.
from browser_use import Agent, Browser, ChatBrowserUse
browser = Browser(
use_cloud=True, # Automatically provisions a cloud browser
)
agent = Agent(
task="Find the number of stars of the browser-use repo",
llm=ChatBrowserUse(),
browser=browser,
)
agent.run_sync()
Optional: Follow the link in the console to watch the remote browser.
Check out the cloud docs for more!
Demos
📋 Form-Filling
Task = "Fill in this job application with my resume and information."
🍎 Grocery-Shopping
Task = "Put this list of items into my instacart."
https://github.com/user-attachments/assets/a6813fa7-4a7c-40a6-b4aa-382bf88b1850
💻 Personal-Assistant.
Task = "Help me find parts for a custom PC."
https://github.com/user-attachments/assets/ac34f75c-057a-43ef-ad06-5b2c9d42bf06
💡See more examples here ↗ and give us a star!
Integrations, hosting, custom tools, MCP, and more on our Docs ↗
Made with ❤️ in Zurich and San Francisco
Description
browser-use: Direct browser control via CDP for web interaction: automation, scraping, testing, screenshots, and site/app work.; remote-browser: Controls an isolated Browser Use Cloud browser from a sandboxed machine with the current Browser Use CLI.; open-source: Documentation reference for writing Python code using the browser-use open-source library. Use this skill whenever the user needs help with Agent, Browser, or…; cloud: Documentation reference for using Browser Use Cloud — the hosted A…
Readme
MIT
120 MiB
Languages
Python
99.2%
Shell
0.3%
Dockerfile
0.3%
HTML
0.2%