{"info":{"author":"Gregor Zunic","author_email":null,"bugtrack_url":null,"classifiers":["License :: OSI Approved :: MIT License","Operating System :: OS Independent","Programming Language :: Python :: 3"],"description":"<picture>\n  <source media=\"(prefers-color-scheme: light)\" srcset=\"https:\/\/github.com\/user-attachments\/assets\/2ccdb752-22fb-41c7-8948-857fc1ad7e24\"\">\n  <source media=\"(prefers-color-scheme: dark)\" srcset=\"https:\/\/github.com\/user-attachments\/assets\/774a46d5-27a0-490c-b7d0-e65fcbbfa358\">\n  <img 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\">\n<\/picture>\n\n<div align=\"center\">\n    <picture>\n    <source media=\"(prefers-color-scheme: light)\" srcset=\"https:\/\/github.com\/user-attachments\/assets\/9955dda9-ede3-4971-8ee0-91cbc3850125\"\">\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"https:\/\/github.com\/user-attachments\/assets\/6797d09b-8ac3-4cb9-ba07-b289e080765a\">\n    <img alt=\"The AI browser agent.\" src=\"https:\/\/github.com\/user-attachments\/assets\/9955dda9-ede3-4971-8ee0-91cbc3850125\"  width=\"400\">\n    <\/picture>\n<\/div>\n\n<div align=\"center\">\n<a href=\"https:\/\/cloud.browser-use.com\"><img src=\"https:\/\/media.browser-use.tools\/badges\/package\" height=\"48\" alt=\"Browser-Use Package Download Statistics\"><\/a>\n<\/div>\n\n---\n\n<div align=\"center\">\n<a href=\"#demos\"><img src=\"https:\/\/media.browser-use.tools\/badges\/demos\" alt=\"Demos\"><\/a>\n<img width=\"16\" height=\"1\" alt=\"\">\n<a href=\"https:\/\/docs.browser-use.com\"><img src=\"https:\/\/media.browser-use.tools\/badges\/docs\" alt=\"Docs\"><\/a>\n<img width=\"16\" height=\"1\" alt=\"\">\n<a href=\"https:\/\/browser-use.com\/posts\"><img src=\"https:\/\/media.browser-use.tools\/badges\/blog\" alt=\"Blog\"><\/a>\n<img width=\"16\" height=\"1\" alt=\"\">\n<a href=\"https:\/\/browsermerch.com\"><img src=\"https:\/\/media.browser-use.tools\/badges\/merch\" alt=\"Merch\"><\/a>\n<img width=\"100\" height=\"1\" alt=\"\">\n<a href=\"https:\/\/github.com\/browser-use\/browser-use\"><img src=\"https:\/\/media.browser-use.tools\/badges\/github\" alt=\"Github Stars\"><\/a>\n<img width=\"4\" height=\"1\" alt=\"\">\n<a href=\"https:\/\/x.com\/intent\/user?screen_name=browser_use\"><img src=\"https:\/\/media.browser-use.tools\/badges\/twitter\" alt=\"Twitter\"><\/a>\n<img width=\"4 height=\"1\" alt=\"\">\n<a href=\"https:\/\/link.browser-use.com\/discord\"><img src=\"https:\/\/media.browser-use.tools\/badges\/discord\" alt=\"Discord\"><\/a>\n<img width=\"4\" height=\"1\" alt=\"\">\n<a href=\"https:\/\/cloud.browser-use.com\"><img src=\"https:\/\/media.browser-use.tools\/badges\/cloud\" height=\"48\" alt=\"Browser-Use Cloud\"><\/a>\n<\/div>\n\n<\/br>\n\n\ud83c\udf24\ufe0f Want to skip the setup? Use our <b>[cloud](https:\/\/cloud.browser-use.com)<\/b> for faster, scalable, stealth-enabled browser automation!\n\n# \ud83e\udd16 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<br\/>\n\n# \ud83d\udc4b Human Quickstart\n\n**1. Create environment with [uv](https:\/\/docs.astral.sh\/uv\/) (Python>=3.11):**\n```bash\nuv init\n```\n\n**2. Install Browser-Use package:**\n```bash\n#  We ship every day - use the latest version!\nuv add browser-use\nuv sync\n```\n\n**3. Get your API key from [Browser Use Cloud](https:\/\/cloud.browser-use.com\/new-api-key) and add it to your `.env` file (new signups get $10 free credits):**\n```\n# .env\nBROWSER_USE_API_KEY=your-key\n```\n\n**4. Install Chromium browser:**\n```bash\nuvx browser-use install\n```\n\n**5. Run your first agent:**\n```python\nfrom browser_use import Agent, Browser, ChatBrowserUse\nimport asyncio\n\nasync def example():\n    browser = Browser(\n        # use_cloud=True,  # Uncomment to use a stealth browser on Browser Use Cloud\n    )\n\n    llm = ChatBrowserUse()\n\n    agent = Agent(\n        task=\"Find the number of stars of the browser-use repo\",\n        llm=llm,\n        browser=browser,\n    )\n\n    history = await agent.run()\n    return history\n\nif __name__ == \"__main__\":\n    history = asyncio.run(example())\n```\n\nCheck out the [library docs](https:\/\/docs.browser-use.com) and the [cloud docs](https:\/\/docs.cloud.browser-use.com) for more!\n\n<br\/>\n\n# \ud83d\udd25 Deploy on Sandboxes\n\nWe handle agents, browsers, persistence, auth, cookies, and LLMs. The agent runs right next to the browser for minimal latency.\n\n```python\nfrom browser_use import Browser, sandbox, ChatBrowserUse\nfrom browser_use.agent.service import Agent\nimport asyncio\n\n@sandbox()\nasync def my_task(browser: Browser):\n    agent = Agent(task=\"Find the top HN post\", browser=browser, llm=ChatBrowserUse())\n    await agent.run()\n\n# Just call it like any async function\nasyncio.run(my_task())\n```\n\nSee [Going to Production](https:\/\/docs.browser-use.com\/production) for more details.\n\n<br\/>\n\n# \ud83d\ude80 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<br\/>\n\n# \ud83d\udcbb 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<br\/>\n\n# Demos\n\n\n### \ud83d\udccb 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 \u2197](https:\/\/github.com\/browser-use\/browser-use\/blob\/main\/examples\/use-cases\/apply_to_job.py)\n\n\n### \ud83c\udf4e 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 \u2197](https:\/\/github.com\/browser-use\/browser-use\/blob\/main\/examples\/use-cases\/buy_groceries.py)\n\n\n### \ud83d\udcbb 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 \u2197](https:\/\/github.com\/browser-use\/browser-use\/blob\/main\/examples\/use-cases\/pcpartpicker.py)\n\n\n### \ud83d\udca1See [more examples here \u2197](https:\/\/docs.browser-use.com\/examples) and give us a star!\n\n<br\/>\n\n## Integrations, hosting, custom tools, MCP, and more on our [Docs \u2197](https:\/\/docs.browser-use.com)\n\n<br\/>\n\n# FAQ\n\n<details>\n<summary><b>What's the best model to use?<\/b><\/summary>\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<\/details>\n\n\n<details>\n<summary><b>Can I use custom tools with the agent?<\/b><\/summary>\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) -> 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<\/details>\n\n<details>\n<summary><b>Can I use this for free?<\/b><\/summary>\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<\/details>\n\n<details>\n<summary><b>How do I handle authentication?<\/b><\/summary>\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<\/details>\n\n<details>\n<summary><b>How do I solve CAPTCHAs?<\/b><\/summary>\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<\/details>\n\n<details>\n<summary><b>How do I go into production?<\/b><\/summary>\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<\/details>\n\n<br\/>\n\n<div align=\"center\">\n\n**Tell your computer what to do, and it gets it done.**\n\n<img src=\"https:\/\/github.com\/user-attachments\/assets\/06fa3078-8461-4560-b434-445510c1766f\" width=\"400\"\/>\n\n[![Twitter Follow](https:\/\/img.shields.io\/twitter\/follow\/Magnus?style=social)](https:\/\/x.com\/intent\/user?screen_name=mamagnus00)\n&emsp;&emsp;&emsp;\n[![Twitter Follow](https:\/\/img.shields.io\/twitter\/follow\/Gregor?style=social)](https:\/\/x.com\/intent\/user?screen_name=gregpr07)\n\n<\/div>\n\n<div align=\"center\"> Made with \u2764\ufe0f in Zurich and San Francisco <\/div>\n","description_content_type":"text\/markdown","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":null,"keywords":null,"license":null,"license_expression":null,"license_files":["LICENSE"],"maintainer":null,"maintainer_email":null,"name":"browser-use","package_url":"https:\/\/pypi.org\/project\/browser-use\/","platform":null,"project_url":"https:\/\/pypi.org\/project\/browser-use\/","project_urls":{"Repository":"https:\/\/github.com\/browser-use\/browser-use"},"provides_extra":["all","aws","cli","cli-oci","code","eval","examples","oci","video"],"release_url":"https:\/\/pypi.org\/project\/browser-use\/0.11.9\/","requires_dist":["aiohttp>=3.13.3","anthropic<1.0.0,>=0.72.1","anyio>=4.9.0","authlib>=1.6.0","browser-use-sdk>=2.0.12","bubus>=1.5.6","cdp-use>=1.4.4","click>=8.1.8","cloudpickle>=3.1.1","google-api-core>=2.25.0","google-api-python-client>=2.174.0","google-auth-oauthlib>=1.2.2","google-auth>=2.40.3","google-genai<2.0.0,>=1.50.0","groq>=0.30.0","httpx>=0.28.1","inquirerpy>=0.3.4","markdownify>=1.2.0","mcp>=1.10.1","ollama>=0.5.1","openai<3.0.0,>=2.7.2","pillow>=11.2.1","portalocker<3.0.0,>=2.7.0","posthog>=3.7.0","psutil>=7.0.0","pydantic>=2.11.5","pyobjc>=11.0; platform_system == \"darwin\"","pyotp>=2.9.0","pypdf>=5.7.0","python-docx>=1.2.0","python-dotenv>=1.0.1","reportlab>=4.0.0","requests>=2.32.3","rich>=14.0.0","screeninfo>=0.8.1; platform_system != \"darwin\"","typing-extensions>=4.12.2","uuid7>=0.1.0","agentmail==0.0.59; extra == \"all\"","boto3>=1.38.45; extra == \"all\"","botocore>=1.37.23; extra == \"all\"","imgcat>=0.6.0; extra == \"all\"","langchain-openai>=0.3.26; extra == \"all\"","oci>=2.126.4; extra == \"all\"","textual>=3.2.0; extra == \"all\"","boto3>=1.38.45; extra == \"aws\"","textual>=3.2.0; extra == \"cli\"","oci>=2.126.4; extra == \"cli-oci\"","textual>=3.2.0; extra == \"cli-oci\"","matplotlib>=3.9.0; extra == \"code\"","numpy>=2.3.2; extra == \"code\"","pandas>=2.2.0; extra == \"code\"","tabulate>=0.9.0; extra == \"code\"","anyio>=4.9.0; extra == \"eval\"","datamodel-code-generator>=0.26.0; extra == \"eval\"","lmnr[all]==0.7.17; extra == \"eval\"","psutil>=7.0.0; extra == \"eval\"","agentmail==0.0.59; extra == \"examples\"","botocore>=1.37.23; extra == \"examples\"","imgcat>=0.6.0; extra == \"examples\"","langchain-openai>=0.3.26; extra == \"examples\"","oci>=2.126.4; extra == \"oci\"","imageio[ffmpeg]>=2.37.0; extra == \"video\"","numpy>=2.3.2; extra == \"video\""],"requires_python":"<4.0,>=3.11","summary":"Make websites accessible for AI agents","version":"0.11.9","yanked":false,"yanked_reason":null},"last_serial":43748039,"ownership":{"organization":null,"roles":[{"role":"Owner","user":"gregpr07"}]},"urls":[{"comment_text":null,"core-metadata":{"sha256":"3ddc6bf8ad057743a69a2d9ca4107067e819af73ccfba0bbe9628e5b13d223b0"},"digests":{"blake2b_256":"d63cf8630cf1b6bc9a95d6e1c974a5cf8eefdc3bbcba5d4a903f7cd722f4fb95","md5":"7f00e0a34e46772873ac95837f2a2964","sha256":"a66accf4dded24d056eb2733e354e159fd7d82cab986d75dc0f14b395467c82c"},"downloads":-1,"filename":"browser_use-0.11.9-py3-none-any.whl","has_sig":false,"md5_digest":"7f00e0a34e46772873ac95837f2a2964","packagetype":"bdist_wheel","python_version":"py3","requires_python":"<4.0,>=3.11","size":699820,"upload_time":"2026-02-06T05:28:52","upload_time_iso_8601":"2026-02-06T05:28:52.851810Z","url":"https:\/\/files.pythonhosted.org\/packages\/d6\/3c\/f8630cf1b6bc9a95d6e1c974a5cf8eefdc3bbcba5d4a903f7cd722f4fb95\/browser_use-0.11.9-py3-none-any.whl","yanked":false,"yanked_reason":null},{"comment_text":null,"core-metadata":false,"digests":{"blake2b_256":"8199200f7b856f555970eacb8c852f73839e51a7d658c24a7739293e9eee2158","md5":"7b01bc9e56efd02ac75522e51a35adae","sha256":"c3d8a420acf26d26c688c42916358ba546e7159e1a699c06064b899cb7927577"},"downloads":-1,"filename":"browser_use-0.11.9.tar.gz","has_sig":false,"md5_digest":"7b01bc9e56efd02ac75522e51a35adae","packagetype":"sdist","python_version":"source","requires_python":"<4.0,>=3.11","size":589771,"upload_time":"2026-02-06T05:28:51","upload_time_iso_8601":"2026-02-06T05:28:51.093152Z","url":"https:\/\/files.pythonhosted.org\/packages\/81\/99\/200f7b856f555970eacb8c852f73839e51a7d658c24a7739293e9eee2158\/browser_use-0.11.9.tar.gz","yanked":false,"yanked_reason":null}],"vulnerabilities":[]}