{"id":23439334,"url":"https://github.com/browser-use/browser-use","last_synced_at":"2026-04-02T11:03:57.118Z","repository":{"id":261252896,"uuid":"881458615","full_name":"browser-use/browser-use","owner":"browser-use","description":"🌐 Make websites accessible for AI agents. Automate tasks online with ease.","archived":false,"fork":false,"pushed_at":"2026-01-28T18:59:48.000Z","size":27933,"stargazers_count":77321,"open_issues_count":224,"forks_count":9159,"subscribers_count":409,"default_branch":"main","last_synced_at":"2026-01-28T21:04:08.977Z","etag":null,"topics":["ai-agents","ai-tools","browser-automation","browser-use","llm","playwright","python"],"latest_commit_sha":null,"homepage":"https://browser-use.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/browser-use.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":"docs/supported-models.mdx","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2024-10-31T16:00:56.000Z","updated_at":"2026-01-28T20:50:06.000Z","dependencies_parsed_at":"2024-11-05T15:21:51.683Z","dependency_job_id":"5f656f14-3507-41b8-927c-4059ef79680b","html_url":"https://github.com/browser-use/browser-use","commit_stats":null,"previous_names":["gregpr07/browser-use","browser-use/browser-use"],"tags_count":125,"template":false,"template_full_name":null,"purl":"pkg:github/browser-use/browser-use","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fbrowser-use","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fbrowser-use/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fbrowser-use/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fbrowser-use/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/browser-use","download_url":"https://codeload.github.com/browser-use/browser-use/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fbrowser-use/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28965436,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T02:14:24.993Z","status":"ssl_error","status_checked_at":"2026-02-01T02:13:55.706Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-tools","browser-automation","browser-use","llm","playwright","python"],"created_at":"2024-12-23T15:01:46.589Z","updated_at":"2026-04-02T11:03:57.111Z","avatar_url":"https://github.com/browser-use.png","language":"Python","readme":"\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://github.com/user-attachments/assets/2ccdb752-22fb-41c7-8948-857fc1ad7e24\"\"\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/user-attachments/assets/774a46d5-27a0-490c-b7d0-e65fcbbfa358\"\u003e\n  \u003cimg alt=\"Shows a black Browser Use Logo in light color mode and a white one in dark color mode.\" src=\"https://github.com/user-attachments/assets/2ccdb752-22fb-41c7-8948-857fc1ad7e24\"  width=\"full\"\u003e\n\u003c/picture\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://github.com/user-attachments/assets/9955dda9-ede3-4971-8ee0-91cbc3850125\"\"\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/user-attachments/assets/6797d09b-8ac3-4cb9-ba07-b289e080765a\"\u003e\n    \u003cimg alt=\"The AI browser agent.\" src=\"https://github.com/user-attachments/assets/9955dda9-ede3-4971-8ee0-91cbc3850125\"  width=\"400\"\u003e\n    \u003c/picture\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://cloud.browser-use.com\"\u003e\u003cimg src=\"https://media.browser-use.tools/badges/package\" height=\"48\" alt=\"Browser-Use Package Download Statistics\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"#demos\"\u003e\u003cimg src=\"https://media.browser-use.tools/badges/demos\" alt=\"Demos\"\u003e\u003c/a\u003e\n\u003cimg width=\"16\" height=\"1\" alt=\"\"\u003e\n\u003ca href=\"https://docs.browser-use.com\"\u003e\u003cimg src=\"https://media.browser-use.tools/badges/docs\" alt=\"Docs\"\u003e\u003c/a\u003e\n\u003cimg width=\"16\" height=\"1\" alt=\"\"\u003e\n\u003ca href=\"https://browser-use.com/posts\"\u003e\u003cimg src=\"https://media.browser-use.tools/badges/blog\" alt=\"Blog\"\u003e\u003c/a\u003e\n\u003cimg width=\"16\" height=\"1\" alt=\"\"\u003e\n\u003ca href=\"https://browsermerch.com\"\u003e\u003cimg src=\"https://media.browser-use.tools/badges/merch\" alt=\"Merch\"\u003e\u003c/a\u003e\n\u003cimg width=\"100\" height=\"1\" alt=\"\"\u003e\n\u003ca href=\"https://github.com/browser-use/browser-use\"\u003e\u003cimg src=\"https://media.browser-use.tools/badges/github\" alt=\"Github Stars\"\u003e\u003c/a\u003e\n\u003cimg width=\"4\" height=\"1\" alt=\"\"\u003e\n\u003ca href=\"https://x.com/intent/user?screen_name=browser_use\"\u003e\u003cimg src=\"https://media.browser-use.tools/badges/twitter\" alt=\"Twitter\"\u003e\u003c/a\u003e\n\u003cimg width=\"4 height=\"1\" alt=\"\"\u003e\n\u003ca href=\"https://link.browser-use.com/discord\"\u003e\u003cimg src=\"https://media.browser-use.tools/badges/discord\" alt=\"Discord\"\u003e\u003c/a\u003e\n\u003cimg width=\"4\" height=\"1\" alt=\"\"\u003e\n\u003ca href=\"https://cloud.browser-use.com\"\u003e\u003cimg src=\"https://media.browser-use.tools/badges/cloud\" height=\"48\" alt=\"Browser-Use Cloud\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n\u003c/br\u003e\n\n🌤️ Want to skip the setup? Use our \u003cb\u003e[cloud](https://cloud.browser-use.com)\u003c/b\u003e for faster, scalable, stealth-enabled browser automation!\n\n# 🤖 LLM Quickstart\n\n1. Direct your favorite coding agent (Cursor, Claude Code, etc) to [Agents.md](https://docs.browser-use.com/llms-full.txt)\n2. Prompt away!\n\n\u003cbr/\u003e\n\n# 👋 Human Quickstart\n\n**1. Create environment and install Browser-Use with [uv](https://docs.astral.sh/uv/) (Python\u003e=3.11):**\n```bash\nuv init \u0026\u0026 uv add browser-use \u0026\u0026 uv sync\n# uvx browser-use install  # Run if you don't have Chromium installed\n```\n\n**2. [Optional] Get your API key from [Browser Use Cloud](https://cloud.browser-use.com/new-api-key):**\n```\n# .env\nBROWSER_USE_API_KEY=your-key\n# GOOGLE_API_KEY=your-key\n# ANTHROPIC_API_KEY=your-key\n```\n\n**3. Run your first agent:**\n```python\nfrom browser_use import Agent, Browser, ChatBrowserUse\n# from browser_use import ChatGoogle  # ChatGoogle(model='gemini-3-flash-preview')\n# from browser_use import ChatAnthropic  # ChatAnthropic(model='claude-sonnet-4-6')\nimport asyncio\n\nasync def main():\n    browser = Browser(\n        # use_cloud=True,  # Use a stealth browser on Browser Use Cloud\n    )\n\n    agent = Agent(\n        task=\"Find the number of stars of the browser-use repo\",\n        llm=ChatBrowserUse(),\n        # llm=ChatGoogle(model='gemini-3-flash-preview'),\n        # llm=ChatAnthropic(model='claude-sonnet-4-6'),\n        browser=browser,\n    )\n    await agent.run()\n\nif __name__ == \"__main__\":\n    asyncio.run(main())\n```\n\nCheck out the [library docs](https://docs.browser-use.com/open-source/introduction) and the [cloud docs](https://docs.cloud.browser-use.com) for more!\n\n\u003cbr/\u003e\n\n# Open Source vs Cloud\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"static/accuracy_by_model_light.png\"\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"static/accuracy_by_model_dark.png\"\u003e\n  \u003cimg alt=\"BU Bench V1 - LLM Success Rates\" src=\"static/accuracy_by_model_light.png\" width=\"100%\"\u003e\n\u003c/picture\u003e\n\nWe benchmark Browser Use across 100 real-world browser tasks. Full benchmark is open source: **[browser-use/benchmark](https://github.com/browser-use/benchmark)**.\n\n**Use Open Source**\n- You need [custom tools](https://docs.browser-use.com/customize/tools/basics) or deep code-level integration\n- You want to self-host and deploy browser agents on your own machines\n\n**Use [Cloud](https://cloud.browser-use.com) (recommended)**\n- Much better agent for complex tasks (see plot above)\n- Easiest way to start and scale\n- Best stealth with proxy rotation and captcha solving\n- 1000+ integrations (Gmail, Slack, Notion, and more)\n- Persistent filesystem and memory\n\n**Use Both**\n- Use the open-source library with your [custom tools](https://docs.browser-use.com/customize/tools/basics) while running our [cloud browsers](https://docs.browser-use.com/open-source/customize/browser/remote) and [ChatBrowserUse model](https://docs.browser-use.com/open-source/supported-models)\n\n\u003cbr/\u003e\n\n# Demos\n\n\n### 📋 Form-Filling\n#### Task = \"Fill in this job application with my resume and information.\"\n![Job Application Demo](https://github.com/user-attachments/assets/57865ee6-6004-49d5-b2c2-6dff39ec2ba9)\n[Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/apply_to_job.py)\n\n\n### 🍎 Grocery-Shopping\n#### Task = \"Put this list of items into my instacart.\"\n\nhttps://github.com/user-attachments/assets/a6813fa7-4a7c-40a6-b4aa-382bf88b1850\n\n[Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/buy_groceries.py)\n\n\n### 💻 Personal-Assistant.\n#### Task = \"Help me find parts for a custom PC.\"\n\nhttps://github.com/user-attachments/assets/ac34f75c-057a-43ef-ad06-5b2c9d42bf06\n\n[Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/pcpartpicker.py)\n\n\n### 💡See [more examples here ↗](https://docs.browser-use.com/examples) and give us a star!\n\n\u003cbr/\u003e\n\n# 🚀 Template Quickstart\n\n**Want to get started even faster?** Generate a ready-to-run template:\n\n```bash\nuvx browser-use init --template default\n```\n\nThis creates a `browser_use_default.py` file with a working example. Available templates:\n- `default` - Minimal setup to get started quickly\n- `advanced` - All configuration options with detailed comments\n- `tools` - Examples of custom tools and extending the agent\n\nYou can also specify a custom output path:\n```bash\nuvx browser-use init --template default --output my_agent.py\n```\n\n\u003cbr/\u003e\n\n# 💻 CLI\n\nFast, persistent browser automation from the command line:\n\n```bash\nbrowser-use open https://example.com    # Navigate to URL\nbrowser-use state                       # See clickable elements\nbrowser-use click 5                     # Click element by index\nbrowser-use type \"Hello\"                # Type text\nbrowser-use screenshot page.png         # Take screenshot\nbrowser-use close                       # Close browser\n```\n\nThe CLI keeps the browser running between commands for fast iteration. See [CLI docs](browser_use/skill_cli/README.md) for all commands.\n\n### Claude Code Skill\n\nFor [Claude Code](https://claude.ai/code), install the skill to enable AI-assisted browser automation:\n\n```bash\nmkdir -p ~/.claude/skills/browser-use\ncurl -o ~/.claude/skills/browser-use/SKILL.md \\\n  https://raw.githubusercontent.com/browser-use/browser-use/main/skills/browser-use/SKILL.md\n```\n\n\u003cbr/\u003e\n\n## Integrations, hosting, custom tools, MCP, and more on our [Docs ↗](https://docs.browser-use.com)\n\n\u003cbr/\u003e\n\n# FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWhat's the best model to use?\u003c/b\u003e\u003c/summary\u003e\n\nWe optimized **ChatBrowserUse()** specifically for browser automation tasks. On avg it completes tasks 3-5x faster than other models with SOTA accuracy.\n\n**Pricing (per 1M tokens):**\n- Input tokens: $0.20\n- Cached input tokens: $0.02\n- Output tokens: $2.00\n\nFor other LLM providers, see our [supported models documentation](https://docs.browser-use.com/supported-models).\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eShould I use the Browser Use system prompt with the open-source preview model?\u003c/b\u003e\u003c/summary\u003e\n\nYes. If you use `ChatBrowserUse(model='browser-use/bu-30b-a3b-preview')` with a normal `Agent(...)`, Browser Use still sends its default agent system prompt for you.\n\nYou do **not** need to add a separate custom \"Browser Use system message\" just because you switched to the open-source preview model. Only use `extend_system_message` or `override_system_message` when you intentionally want to customize the default behavior for your task.\n\nIf you want the best default speed/accuracy, we still recommend the newer hosted `bu-*` models. If you want the open-source preview model, the setup stays the same apart from the `model=` value.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCan I use custom tools with the agent?\u003c/b\u003e\u003c/summary\u003e\n\nYes! You can add custom tools to extend the agent's capabilities:\n\n```python\nfrom browser_use import Tools\n\ntools = Tools()\n\n@tools.action(description='Description of what this tool does.')\ndef custom_tool(param: str) -\u003e str:\n    return f\"Result: {param}\"\n\nagent = Agent(\n    task=\"Your task\",\n    llm=llm,\n    browser=browser,\n    tools=tools,\n)\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCan I use this for free?\u003c/b\u003e\u003c/summary\u003e\n\nYes! 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).\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eTerms of Service\u003c/b\u003e\u003c/summary\u003e\n\nThis open-source library is licensed under the MIT License. For Browser Use services \u0026 data policy, see our [Terms of Service](https://browser-use.com/legal/terms-of-service) and [Privacy Policy](https://browser-use.com/privacy/).\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eHow do I handle authentication?\u003c/b\u003e\u003c/summary\u003e\n\nCheck out our authentication examples:\n- [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\n- If you want to use temporary accounts with inbox, choose AgentMail\n- 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)\n\nThese examples show how to maintain sessions and handle authentication seamlessly.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eHow do I solve CAPTCHAs?\u003c/b\u003e\u003c/summary\u003e\n\nFor 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.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eHow do I go into production?\u003c/b\u003e\u003c/summary\u003e\n\nChrome can consume a lot of memory, and running many agents in parallel can be tricky to manage.\n\nFor production use cases, use our [Browser Use Cloud API](https://cloud.browser-use.com) which handles:\n- Scalable browser infrastructure\n- Memory management\n- Proxy rotation\n- Stealth browser fingerprinting\n- High-performance parallel execution\n\u003c/details\u003e\n\n\u003cbr/\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n**Tell your computer what to do, and it gets it done.**\n\n\u003cimg src=\"https://github.com/user-attachments/assets/06fa3078-8461-4560-b434-445510c1766f\" width=\"400\"/\u003e\n\n[![Twitter Follow](https://img.shields.io/twitter/follow/Magnus?style=social)](https://x.com/intent/user?screen_name=mamagnus00)\n\u0026emsp;\u0026emsp;\u0026emsp;\n[![Twitter Follow](https://img.shields.io/twitter/follow/Gregor?style=social)](https://x.com/intent/user?screen_name=gregpr07)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e Made with ❤️ in Zurich and San Francisco \u003c/div\u003e\n","funding_links":[],"categories":["Skills Catalog","Python","AI Agent Frameworks","AI Agents for Testing","Projects","🤖 AI-Powered Scraping","python","AI助手","Browser \u0026 Desktop Ops Agents","Web Crawling","ai-agents","Web App Testing","🌐 Web Automation \u0026 Scraping","Browser-extensions","语言资源库","Miscellaneous","🚀 Specialized Agents","HarmonyOS","Papers","4. Web Browsing Agents","\u003ca id=\"tools\"\u003e\u003c/a\u003e🛠️ Tools","Tools","Repos","Runtime","Browser Automation \u0026 UI Agents","Table of Contents","GUI \u0026 Computer Control AI Agents","AI应用","\u003ca name=\"Python\"\u003e\u003c/a\u003ePython","App","🕸️ Web Scraping \u0026 Crawling","📈 Trending Vibe-Coding Repos (Auto-updated 2026-04-06)","LLM Application / RAG","Agent Harnessing and Evaluation","Frameworks","📝 AI Web Automation Frameworks","Frameworks \u0026 Libraries","🌐 Browser Automation \u0026 Computer Use","AI Browser Agents","Browser \u0026 Web Automation"],"sub_categories":["Agent (45)","Browser Automation Agents",".NET","AI Agents \u0026 Templates","browser-use","🟩 Development Tools 🛠️","python","🌐 Web Agents","Windows Manager","Frameworks \u0026 Models","Tools","4.1 Open Source Web Browsing Agents","Bleeding Edge ⚗️","AI","Tool","Specialized Tools","Agent","Browser \u0026 Web Automation","Benchmark Reality Check (real-world tool use)","Open Source","Browser Agents","Browser Automation","AI Browser Agents","Specialized CLI Tools","Agent Web Interaction"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowser-use%2Fbrowser-use","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrowser-use%2Fbrowser-use","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowser-use%2Fbrowser-use/lists"}