-# What can Browser Use do?
+# Browser Use 能做什么？
-Browser Use lets an AI agent use a web browser the same way you do — it opens pages, clicks buttons, types, and fills in forms. You describe the task, and it completes it. For example, you can have it:
+Browser Use 让 AI 智能体（agent）像你一样使用网页浏览器——打开页面、点击按钮、输入文字、填写表单。你描述任务，它就能完成。例如，你可以让它：
-### 📋 Fill Forms
-#### Task: "Fill in this job application with my resume and information."
+### 📋 填写表单
+#### 任务："用我的简历和信息填写这份工作申请。"
-[Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/apply_to_job.py)
+[示例代码 ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/apply_to_job.py)
-### 🍎 Shop for Groceries
-#### Task: "Put this list of items into my instacart."
+### 🍎 购买日用品
+#### 任务："把这份物品清单加入我的 instacart。"
https://github.com/user-attachments/assets/a6813fa7-4a7c-40a6-b4aa-382bf88b1850
-[Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/buy_groceries.py)
+[示例代码 ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/buy_groceries.py)
-### 💻 Be Your Personal Assistant
-#### Task: "Help me find parts for a custom PC."
+### 💻 做你的个人助理
+#### 任务："帮我找组装定制 PC 的零件。"
https://github.com/user-attachments/assets/ac34f75c-057a-43ef-ad06-5b2c9d42bf06
-[Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/pcpartpicker.py)
+[示例代码 ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/pcpartpicker.py)
-# Quickstart
+# 快速入门
-If you want to use Browser Use in your agent (Claude Code, Codex, Cursor, Hermes, OpenClaw, etc.), paste this prompt, and it sets everything up itself:
+如果你想在智能体（Claude Code、Codex、Cursor、Hermes、OpenClaw 等）中使用 Browser Use，粘贴这段提示词，它会自动完成所有设置：
```text
Install or upgrade browser-use to the latest stable version with uv using Python 3.12, run `browser-use skill install` to register the skill, and connect it to my browser. If setup or connection fails, follow https://github.com/browser-use/browser-harness/blob/main/install.md.
```
-Then tell your agent what you want done.
+然后告诉你的智能体你想做什么。
-# Python library: the easiest way to automate the web
+# Python 库：自动化网页的最简方式
-Want to automate the web at scale, from your own code, and with any LLM? Use the Python library:
+想在自己的代码里、配合任意大语言模型（LLM）、大规模自动化网页操作？请使用 Python 库：
-**1. Install Browser Use (Python >= 3.11):**
+**1. 安装 Browser Use（Python >= 3.11）：**
```bash
uv add browser-use
# or: pip install browser-use
```
-**2. Add your LLM API key to `.env`**. Get one from [Browser Use Cloud](https://cloud.browser-use.com/new-api-key?utm_source=github&utm_medium=readme-quickstart-api-key), or bring your own provider key:
+**2. 将你的 LLM API 密钥添加到 `.env`**。可从 [Browser Use Cloud](https://cloud.browser-use.com/new-api-key?utm_source=github&utm_medium=readme-quickstart-api-key), 获取，或使用你自己的服务商密钥：
```bash
# .env
@@ -99,7 +105,7 @@ BROWSER_USE_API_KEY=your-key
# ANTHROPIC_API_KEY=your-key
```
-**3. Run your first agent:**
+**3. 运行你的第一个智能体：**
```python
import asyncio
@@ -120,70 +126,71 @@ if __name__ == "__main__":
asyncio.run(main())
```
-Check out the [library docs](https://docs.browser-use.com/open-source/introduction) and the [cloud docs](https://docs.cloud.browser-use.com?utm_source=github&utm_medium=readme-cloud-docs) for more!
+更多内容请参阅[库文档](https://docs.browser-use.com/open-source/introduction) 和[云端文档](https://docs.cloud.browser-use.com?utm_source=github&utm_medium=readme-cloud-docs)！
-# Open Source vs Cloud
+# 开源版 vs 云端版
-
+
-We benchmark Browser Use across 100 real-world browser tasks. Full benchmark is open source: **[browser-use/benchmark](https://github.com/browser-use/benchmark)**.
+我们在 100 个真实浏览器任务上对 Browser Use 进行基准测试。完整基准测试已开源：**[browser-use/benchmark](https://github.com/browser-use/benchmark)**.
-Browser Use is also **#1 on the [Odysseys leaderboard](https://odysseysbench.com/leaderboard)** with an 87.4% average, ahead of computer-use agents from OpenAI, Anthropic, Google, and Microsoft. Odysseys measures the agent's performance on 200 long-horizon web tasks.
+Browser Use 在 **[Odysseys 排行榜](https://odysseysbench.com/leaderboard)** 上也位列 **#1**，平均得分 87.4%，领先于 OpenAI、Anthropic、Google 和 Microsoft 的 computer-use 智能体。Odysseys 会衡量智能体在 200 个长周期网页任务上的表现。
-**Use the Open-Source Agent**
-- Free, and runs on your own machine
-- Deep code-level integration and control: pick your LLM, customize the agent's behavior
-- We recommend pairing it with our [cloud browsers](https://docs.browser-use.com/open-source/customize/browser/remote) for leading stealth, proxy rotation, and scaling
+**使用开源智能体**
+- 免费，可在本机运行
+- 深度代码级集成与控制：自选 LLM、自定义智能体行为
+- 建议搭配我们的[云端浏览器](https://docs.browser-use.com/open-source/customize/browser/remote)，以获得领先的隐身能力、代理轮换和弹性扩展
-**Use the [Fully-Hosted Cloud Agent](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-hosted-agent) (recommended)**
-- Much more powerful agent for complex tasks (see plot above)
-- Easiest way to start and scale
-- Best stealth with proxy rotation and captcha solving
-- 1000+ integrations (Gmail, Slack, Notion, and more)
-- Persistent filesystem and memory
+**使用[全托管云端智能体](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-hosted-agent)（推荐）**
+- 应对复杂任务的智能体能力更强（见上图）
+- 上手和扩展最简单的方式
+- 最佳隐身能力，支持代理轮换与验证码（captcha）破解
+- 1000+ 集成（Gmail、Slack、Notion 等）
+- 持久化文件系统与记忆
-## Integrations, hosting, custom tools, MCP, and more on our [Docs ↗](https://docs.browser-use.com)
+## 集成、托管、自定义工具、MCP 等更多内容，请查看我们的[文档 ↗](https://docs.browser-use.com)
-# FAQ
+# 常见问题
-Should I use the CLI vs. the Python library?
+我该用 CLI 还是 Python 库？
-**Use the CLI** if you already have an agent (Claude Code, Codex, Cursor, Hermes, OpenClaw, etc.) that you want to complete browser tasks for you. The agent installs the skill once (see [Quickstart](#quickstart)) and can then control the browser. Examples:
-- "Upload this video to YouTube"
-- "Compare these three laptops and give me a table with prices"
-- "Fill in this job application with my resume"
+**使用 CLI**：如果你已有智能体（Claude Code、Codex、Cursor、Hermes、OpenClaw 等），想让它帮你完成浏览器任务。智能体只需安装一次技能（见[快速入门](#quickstart)），之后即可控制浏览器。示例：
+- "把这个视频上传到 YouTube"
+- "对比这三台笔记本电脑，给我一张带价格的表格"
+- "用我的简历填写这份工作申请"
-**Use the Python library** when you are building software that automates the web. Examples:
-- Run many tasks on a schedule or in parallel (scraping, monitoring, QA)
-- Embed a browser agent into your own product
-- Custom tools, custom system prompts, structured output, fine-grained browser control
+**使用 Python 库**：当你要构建自动化网页的软件时。示例：
+- 按计划或并行运行大量任务（抓取、监控、QA）
+- 将浏览器智能体嵌入你自己的产品
+- 自定义工具、自定义系统提示词、结构化输出、细粒度浏览器控制
-Rule of thumb: one-off tasks through an agent → CLI. Repeatable automation in code → Python library.
+经验法则：通过智能体做一次性任务 → CLI；在代码中做可重复自动化 → Python 库。
-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.
+我们专门针对浏览器自动化任务优化了 **ChatBrowserUse()**。平均而言，它在达到 SOTA 准确率的同时，完成任务的速度比其他模型快 3-5 倍。
+
-For pricing and other LLM providers, see our [supported models documentation](https://docs.browser-use.com/supported-models).
+关于定价及其他 LLM 提供商，请参阅我们的[支持的模型文档](https://docs.browser-use.com/supported-models).
-Can I use Claude / GPT / Gemini through ChatBrowserUse?
+能否通过 ChatBrowserUse 使用 Claude / GPT / Gemini？
-Yes. `ChatBrowserUse` accepts provider-prefixed model ids, so a single `BROWSER_USE_API_KEY` reaches all of them — no separate OpenAI/Anthropic/Google keys required:
+可以。`ChatBrowserUse` 接受带提供商前缀的 model id，因此单个 `BROWSER_USE_API_KEY` 即可访问全部模型——无需单独的 OpenAI/Anthropic/Google 密钥：
```python
from browser_use import Agent, ChatBrowserUse
@@ -192,23 +199,23 @@ llm = ChatBrowserUse(model='anthropic/claude-sonnet-4-6') # or 'openai/gpt-5.5'
agent = Agent(task='...', llm=llm)
```
-For the best speed and cost we still recommend the default `bu-*` models.
+为获得最佳速度与成本，我们仍推荐使用默认的 `bu-*` 模型。
-Should I use the Browser Use system prompt with the open-source preview model?
+使用开源预览模型时，是否应使用 Browser Use 系统提示词（system prompt）？
-Yes. 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.
+是的。若将 `ChatBrowserUse(model='browser-use/bu-30b-a3b-preview')` 与普通的 `Agent(...)` 搭配使用，Browser Use 仍会为你发送其默认的 agent 系统提示词。
-You 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.
+切换到开源预览模型后，你**无需**额外添加自定义的「Browser Use 系统消息」。仅当你有意针对任务自定义默认行为时，才使用 `extend_system_message` 或 `override_system_message`。
-If 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.
+若追求默认情况下的最佳速度/准确度，我们仍推荐使用较新的托管 `bu-*` 模型。若使用开源预览模型，除 `model=` 取值外，配置方式保持不变。
-Can I use custom tools with the agent?
+能否为 agent 使用自定义工具？
-Yes! You can add custom tools to extend the agent's capabilities:
+可以！你可以添加自定义工具以扩展 agent 的能力：
```python
from browser_use import Tools
@@ -230,52 +237,52 @@ agent = Agent(
-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).
+可以！Browser-Use 是开源的，可免费使用。你只需选择 LLM 提供商（如 OpenAI、Google、ChatBrowserUse，或通过 Ollama 在本地运行模型）。
-Terms of Service
+服务条款
-This open-source library is licensed under the MIT License. For Browser Use services & data policy, see our [Terms of Service](https://browser-use.com/legal/terms-of-service) and [Privacy Policy](https://browser-use.com/privacy/).
+本开源库采用 MIT License 许可。有关 Browser Use 服务与数据政策，请参阅我们的[服务条款](https://browser-use.com/legal/terms-of-service) 和[隐私政策](https://browser-use.com/privacy/).
-How do I handle authentication?
+如何处理身份验证？
-Check out our authentication examples:
-- [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
-- 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)
+请参阅我们的身份验证示例：
+- [使用真实浏览器配置文件](https://github.com/browser-use/browser-use/blob/main/examples/browser/real_browser.py) - 复用已保存登录信息的现有 Chrome 配置文件
+- 若需使用带收件箱的临时账号，可选择 AgentMail
+- 要将身份验证配置文件同步到远程浏览器，请运行 `curl -fsSL https://browser-use.com/profile.sh | BROWSER_USE_API_KEY=XXXX sh`（将 XXXX 替换为你的 API key）
-These examples show how to maintain sessions and handle authentication seamlessly.
+这些示例展示了如何无缝维护会话并处理身份验证。
-How do I solve CAPTCHAs?
+如何解决 CAPTCHA？
-For CAPTCHA handling, you need better browser fingerprinting and proxies. Use [Browser Use Cloud](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-faq-captcha) which provides stealth browsers designed to avoid detection and CAPTCHA challenges.
+处理 CAPTCHA 需要更好的浏览器指纹与代理。请使用 [Browser Use Cloud](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-faq-captcha)，它提供专为规避检测与 CAPTCHA 挑战而设计的隐身浏览器。
-How do I go into production?
+如何投入生产环境？
-Chrome can consume a lot of memory, and running many agents in parallel can be tricky to manage.
+Chrome 会占用大量内存，并行运行多个 agent 的管理也可能较为棘手。
-For production use cases, use our [Browser Use Cloud API](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-faq-production) which handles:
-- Scalable browser infrastructure
-- Memory management
-- Proxy rotation
-- Stealth browser fingerprinting
-- High-performance parallel execution
+生产场景请使用我们的 [Browser Use Cloud API](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-faq-production)，它提供：
+- 可扩展的浏览器基础设施
+- 内存管理
+- 代理轮换
+- 隐身浏览器指纹
+- 高性能并行执行
-## Citation
+## 引用
-If you use Browser Use in your research or project, please cite:
+若在你的研究或项目中使用了 Browser Use，请引用：
```bibtex
@software{browser_use2024,
@@ -291,7 +298,7 @@ If you use Browser Use in your research or project, please cite:
-**Tell your computer what to do, and it gets it done.**
+**告诉电脑做什么，它就能帮你完成。**
+
+
+
+
+
+
+