Enable AI to control your browser

[![Docs](https://img.shields.io/badge/Docs-📕-blue?style=for-the-badge)](https://docs.browser-use.com) [![Browser-use cloud](https://img.shields.io/badge/Browser_Use_Cloud-☁️-blue?style=for-the-badge&logo=rocket&logoColor=white)](https://cloud.browser-use.com) [![Discord](https://img.shields.io/discord/1303749220842340412?color=7289DA&label=Discord&logo=discord&logoColor=white)](https://link.browser-use.com/discord) [![Twitter Follow](https://img.shields.io/twitter/follow/Gregor?style=social)](https://x.com/intent/user?screen_name=gregpr07) [![Twitter Follow](https://img.shields.io/twitter/follow/Magnus?style=social)](https://x.com/intent/user?screen_name=mamagnus00) [![Merch store](https://img.shields.io/badge/Merch_store-👕-blue)](https://browsermerch.com) [![Weave Badge](https://img.shields.io/endpoint?url=https%3A%2F%2Fapp.workweave.ai%2Fapi%2Frepository%2Fbadge%2Forg_T5Pvn3UBswTHIsN1dWS3voPg%2F881458615&labelColor=#EC6341)](https://app.workweave.ai/reports/repository/org_T5Pvn3UBswTHIsN1dWS3voPg/881458615) [Deutsch](https://www.readme-i18n.com/browser-use/browser-use?lang=de) | [Español](https://www.readme-i18n.com/browser-use/browser-use?lang=es) | [français](https://www.readme-i18n.com/browser-use/browser-use?lang=fr) | [日本語](https://www.readme-i18n.com/browser-use/browser-use?lang=ja) | [한국어](https://www.readme-i18n.com/browser-use/browser-use?lang=ko) | [Português](https://www.readme-i18n.com/browser-use/browser-use?lang=pt) | [Русский](https://www.readme-i18n.com/browser-use/browser-use?lang=ru) | [中文](https://www.readme-i18n.com/browser-use/browser-use?lang=zh) # 🤖 Quickstart With uv (Python>=3.11): ```bash # We ship every day - use the latest version! uv pip install browser-use ``` Download chromium using playwright's shortcut: ```bash uvx playwright install chromium --with-deps --no-shell ``` Create a `.env` file and add your API key. Don't have one? Start with a [free Gemini key](https://aistudio.google.com/app/u/1/apikey?pli=1). ```bash GEMINI_API_KEY= ``` Run your first agent: ```python from browser_use import Agent, ChatGoogle from dotenv import load_dotenv load_dotenv() agent = Agent( task="Find the number of stars of the browser-use repo", llm=ChatGoogle(model="gemini-2.5-flash"), # browser=Browser(use_cloud=True), # Uses Browser-Use cloud for the browser ) agent.run_sync() ``` Check out the [library docs](https://docs.browser-use.com) and [cloud docs](https://docs.cloud.browser-use.com) for more settings. # Demos [Task](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/shopping.py): Add grocery items to cart, and checkout. [![AI Did My Groceries](https://github.com/user-attachments/assets/a0ffd23d-9a11-4368-8893-b092703abc14)](https://www.youtube.com/watch?v=L2Ya9PYNns8)

[Task](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/find_and_apply_to_jobs.py): Read my CV & find ML jobs, save them to a file, and then start applying for them in new tabs, if you need help, ask me. https://github.com/user-attachments/assets/171fb4d6-0355-46f2-863e-edb04a828d04

See [more examples](https://docs.browser-use.com/examples) and give us a star!

## MCP Integration This gives Claude Desktop access to browser automation tools for web scraping, form filling, and more. See the [MCP docs](https://docs.browser-use.com/customize/mcp-server). ```json { "mcpServers": { "browser-use": { "command": "uvx", "args": ["browser-use[cli]", "--mcp"], "env": { "OPENAI_API_KEY": "your-openai-api-key" } } } } ```

**Tell your computer what to do, and it gets it done.**

[![Twitter Follow](https://img.shields.io/twitter/follow/Magnus?style=social)](https://x.com/intent/user?screen_name=mamagnus00) [![Twitter Follow](https://img.shields.io/twitter/follow/Gregor?style=social)](https://x.com/intent/user?screen_name=gregpr07)

Made with ❤️ in Zurich and San Francisco