Skip to content

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

readme faq

Magnus Müllerbe592050604f
diff --git a/README.md b/README.md
index 83ffec829..ea8710ee4 100644
--- a/README.md
+++ b/README.md
@@ -144,6 +144,77 @@ https://github.com/user-attachments/assets/ac34f75c-057a-43ef-ad06-5b2c9d42bf06
<br/>
+# FAQ
+
+<details>
+<summary><b>What's the best model to use?</b></summary>
+
+**ChatBrowserUse()** is the fastest option with top SOTA accuracy - it's optimized specifically for browser automation tasks.
+
+For other LLM providers, see our [supported models documentation](https://docs.browser-use.com/category/llm-integration).
+</details>
+
+<details>
+<summary><b>How do I solve CAPTCHAs?</b></summary>
+
+For 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.
+</details>
+
+<details>
+<summary><b>Can I use custom tools with the agent?</b></summary>
+
+Yes! You can add custom tools to extend the agent's capabilities:
+
+```python
+from browser_use.tools import Tool
+
+@Tool()
+def custom_tool(param: str) -> str:
+ """Description of what this tool does."""
+ return f"Result: {param}"
+
+agent = Agent(
+ task="Your task",
+ llm=llm,
+ browser=browser,
+ use_custom_tools=[custom_tool],
+)
+```
+
+See our [Custom Tools documentation](https://docs.browser-use.com/custom-tools) for more examples.
+</details>
+
+<details>
+<summary><b>Can I use this for free?</b></summary>
+
+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).
+</details>
+
+<details>
+<summary><b>How do I handle authentication?</b></summary>
+
+Check out our authentication examples:
+- [Using real browser profiles](https://github.com/browser-use/browser-use/blob/main/examples/integrations/real_browser.py) - Reuse your existing Chrome profile with saved logins
+- [1Password integration](https://github.com/browser-use/browser-use/blob/main/examples/integrations/one_password.py) - Automate password filling
+
+These examples show how to maintain sessions and handle authentication seamlessly.
+</details>
+
+<details>
+<summary><b>How do I go into production?</b></summary>
+
+Chrome can consume a lot of memory, and running many agents in parallel can be tricky to manage.
+
+For production use cases, use our [Browser Use Cloud API](https://cloud.browser-use.com) which handles:
+- Scalable browser infrastructure
+- Memory management
+- Proxy rotation
+- Stealth browser fingerprinting
+- High-performance parallel execution
+</details>
+
+<br/>
+
<div align="center">
**Tell your computer what to do, and it gets it done.**