liqiang
b119135836
Build latest book artifacts / build (push) Canceled after 0s
dependency resolution / resolve (3.11) (push) Canceled after 0s
dependency resolution / resolve (3.13) (push) Canceled after 0s
deploy-pages / build (push) Canceled after 0s
deploy-pages / deploy (push) Canceled after 0s
i18n consistency check / check (push) Canceled after 0s
provider adoption tests / test (chapter2/context-compression) (push) Canceled after 0s
provider adoption tests / test (chapter2/prompt-injection) (push) Canceled after 0s
provider adoption tests / test (chapter2/system-hint) (push) Canceled after 0s
provider adoption tests / test (chapter3/log-sanitization) (push) Canceled after 0s
web-search-agent tests / test (push) Canceled after 0s
web-search-agent tests / agentbook (push) Canceled after 0s
123 lines
4.6 KiB
Markdown
123 lines
4.6 KiB
Markdown
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="./static/browser-use-dark.png">
|
|
<source media="(prefers-color-scheme: light)" srcset="./static/browser-use.png">
|
|
<img alt="Shows a black Browser Use Logo in light color mode and a white one in dark color mode." src="./static/browser-use.png" width="full">
|
|
</picture>
|
|
|
|
<h1 align="center">Enable AI to control your browser</h1>
|
|
|
|
[](https://docs.browser-use.com)
|
|
[](https://cloud.browser-use.com)
|
|
|
|
[](https://link.browser-use.com/discord)
|
|
[](https://x.com/intent/user?screen_name=gregpr07)
|
|
[](https://x.com/intent/user?screen_name=mamagnus00)
|
|
[](https://browsermerch.com)
|
|
[](https://app.workweave.ai/reports/repository/org_T5Pvn3UBswTHIsN1dWS3voPg/881458615)
|
|
|
|
|
|
|
|
|
|
|
|
<!-- Keep these links. Translations will automatically update with the README. -->
|
|
[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.
|
|
|
|
[](https://www.youtube.com/watch?v=L2Ya9PYNns8)
|
|
|
|
<br/><br/>
|
|
|
|
|
|
[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
|
|
|
|
<br/><br/>
|
|
|
|
See [more examples](https://docs.browser-use.com/examples) and give us a star!
|
|
|
|
|
|
<br/><br/>
|
|
## 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"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
<div align="center">
|
|
|
|
**Tell your computer what to do, and it gets it done.**
|
|
|
|
<img src="https://github.com/user-attachments/assets/06fa3078-8461-4560-b434-445510c1766f" width="400"/>
|
|
|
|
[](https://x.com/intent/user?screen_name=mamagnus00)
|
|
[](https://x.com/intent/user?screen_name=gregpr07)
|
|
|
|
</div>
|
|
|
|
<div align="center">
|
|
Made with ❤️ in Zurich and San Francisco
|
|
</div>
|