- 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!
We handle agents, browsers, persistence, auth, cookies, and LLMs. The agent runs right next to the browser for minimal latency.
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 for more details.
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 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 - 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.
![@cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=64&v=4){kind=small}
