Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

docs: clarify open-source Browser Use model prompt setup

Frank175d180c06d5
diff --git a/README.md b/README.md
index eeafa74f0..0c95a5174 100644
--- a/README.md
+++ b/README.md
@@ -187,6 +187,15 @@ We optimized **ChatBrowserUse()** specifically for browser automation tasks. On
For other LLM providers, see our [supported models documentation](https://docs.browser-use.com/supported-models).
</details>
+<details>
+<summary><b>Should I use the Browser Use system prompt with the open-source preview model?</b></summary>
+
+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.
+
+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.
+
+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.
+</details>
<details>
<summary><b>Can I use custom tools with the agent?</b></summary>