- Direct your favorite coding agent (Cursor, ClaudeS, etc) to Agents.md
- Prompt away!
1. Create environment with uv (Python>=3.11):
uv init2. Install Browser-Use package:
# We ship every day - use the latest version!
uv add browser-use
uv sync3. 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. Install Chromium browser:
uvx browser-use install5. 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!
Want to get started even faster? Generate a ready-to-run template:
uvx browser-use init --template defaultThis creates a browser_use_default.py file with a working example. Available templates:
default- Minimal setup to get started quicklyadvanced- All configuration options with detailed commentstools- 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
grocery-use-large.mp4
pc-use-large.mp4
π‘See more examples here β and give us a star!
Integrations, hosting, custom tools, MCP, and more on our Docs β
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.50
- Output tokens: $3.00
- Cached tokens: $0.10
For other LLM providers, see our supported models documentation.
Can I use custom tools with the agent?
Yes! You can add custom tools to extend the agent's capabilities:
from browser_use.tools import Tool
@Tool()
def custom_tool(param: str) -> str:
"""Description of what this tool does."""
return f"Result: {param}"
agent = Agent(
task="Your task",
llm=llm,
browser=browser,
use_custom_tools=[custom_tool],
)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 - 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 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 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.
