Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
update readme
Magnus Müller5432e088eaa0
diff --git a/README.md b/README.mdindex 1fd879b21..41a6e7d19 100644--- a/README.md+++ b/README.md@@ -14,11 +14,8 @@[](https://x.com/intent/user?screen_name=mamagnus00)[](https://app.workweave.ai/reports/repository/org_T5Pvn3UBswTHIsN1dWS3voPg/881458615)-🌐 Browser-use is the easiest way to connect your AI agents with the browser.-💡 See what others are building and share your projects in our [Discord](https://link.browser-use.com/discord)! Want Swag? Check out our [Merch store](https://browsermerch.com).--🌤️ Skip the setup - try our <b>hosted version</b> for instant browser automation! <b>[Try the cloud ☁︎](https://cloud.browser-use.com)</b>.+🌤️ Want to skip the setup? Use our <b>hosted version</b> for faster, scalable, stealth-enabled browser automation! <b>[Try the cloud ☁︎](https://cloud.browser-use.com)</b>.# Quick start@@ -44,8 +41,8 @@ from browser_use import Agent, ChatOpenAIasync def main():agent = Agent(- task="Compare the price of gpt-4o and DeepSeek-V3",- llm=ChatOpenAI(model="o4-mini", temperature=1.0),+ task="Find the number of stars of the browser-use repo",+ llm=ChatOpenAI(model="gpt-4.1-mini"),)await agent.run()@@ -56,29 +53,47 @@ Add your API keys for the provider you want to use to your `.env` file.```bashOPENAI_API_KEY=-ANTHROPIC_API_KEY=-AZURE_OPENAI_ENDPOINT=-AZURE_OPENAI_KEY=-GOOGLE_API_KEY=-DEEPSEEK_API_KEY=-GROK_API_KEY=-NOVITA_API_KEY=```For other settings, models, and more, check out the [documentation 📕](https://docs.browser-use.com).-### Test with UI+# Demos-You can test browser-use using its [Web UI](https://github.com/browser-use/web-ui) or [Desktop App](https://github.com/browser-use/desktop).+<br/><br/>++[Task](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/shopping.py): Add grocery items to cart, and checkout.-### Test with an interactive CLI+[](https://www.youtube.com/watch?v=L2Ya9PYNns8)-You can also use our `browser-use` interactive CLI (similar to `claude` code):+<br/><br/>-```bash-pip install "browser-use[cli]"-browser-use-```+Prompt: Add my latest LinkedIn follower to my leads in Salesforce.++++<br/><br/>++[Prompt](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/>++[Prompt](https://github.com/browser-use/browser-use/blob/main/examples/browser/real_browser.py): Write a letter in Google Docs to my Papa, thanking him for everything, and save the document as a PDF.++++<br/><br/>++[Prompt](https://github.com/browser-use/browser-use/blob/main/examples/custom-functions/save_to_file_hugging_face.py): Look up models with a license of cc-by-sa-4.0 and sort by most likes on Hugging face, save top 5 to file.++https://github.com/user-attachments/assets/de73ee39-432c-4b97-b4e8-939fd7f323b3++<br/><br/>++## More examples++For more examples see the [examples](examples) folder or join the [Discord](https://link.browser-use.com/discord) and show off your project. You can also see our [`awesome-prompts`](https://github.com/browser-use/awesome-prompts) repo for prompting inspiration.## MCP Integration@@ -110,9 +125,8 @@ Browser-use agents can connect to multiple external MCP servers to extend their```pythonimport asyncio-from browser_use import Agent, Controller+from browser_use import Agent, Controller, ChatOpenAIfrom browser_use.mcp.client import MCPClient-from browser_use.llm import ChatOpenAIasync def main():# Initialize controller@@ -141,8 +155,8 @@ async def main():# Create agent with MCP-enabled controlleragent = Agent(- task="Find the latest report.pdf in my documents and create a GitHub issue about it",- llm=ChatOpenAI(model="gpt-4o"),+ task="Find the latest pdf report in my documents and create a GitHub issue about it",+ llm=ChatOpenAI(model="gpt-4.1-mini"),controller=controller # Controller has tools from both MCP servers)@@ -158,43 +172,6 @@ asyncio.run(main())See the [MCP documentation](https://docs.browser-use.com/customize/mcp-server) for more details.-# Demos--<br/><br/>--[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/>--Prompt: Add my latest LinkedIn follower to my leads in Salesforce.----<br/><br/>--[Prompt](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/>--[Prompt](https://github.com/browser-use/browser-use/blob/main/examples/browser/real_browser.py): Write a letter in Google Docs to my Papa, thanking him for everything, and save the document as a PDF.----<br/><br/>--[Prompt](https://github.com/browser-use/browser-use/blob/main/examples/custom-functions/save_to_file_hugging_face.py): Look up models with a license of cc-by-sa-4.0 and sort by most likes on Hugging face, save top 5 to file.--https://github.com/user-attachments/assets/de73ee39-432c-4b97-b4e8-939fd7f323b3--<br/><br/>--## More examples--For more examples see the [examples](examples) folder or join the [Discord](https://link.browser-use.com/discord) and show off your project. You can also see our [`awesome-prompts`](https://github.com/browser-use/awesome-prompts) repo for prompting inspiration.# Vision@@ -203,29 +180,20 @@ Tell your computer what to do, and it gets it done.## Roadmap### Agent--- [ ] Improve agent memory to handle +100 steps-- [ ] Enhance planning capabilities (load website specific context)+- [ ] Make agent 3x faster- [ ] Reduce token consumption (system prompt, DOM state)### DOM Extraction--- [ ] Enable detection for all possible UI elements-- [ ] Improve state representation for UI elements so that all LLMs can understand what's on the page+- [ ] Enable interaction with all UI elements+- [ ] Improve state representation for UI elements so that any LLM can understand what's on the page### Workflows-- [ ] Let user record a workflow - which we can rerun with browser-use as a fallback-- [ ] Make rerunning of workflows work, even if pages change### User Experience-- [ ] Create various templates for tutorial execution, job application, QA testing, social media, etc. which users can just copy & paste.-- [ ] Improve docs-- [ ] Make it faster### Parallelization-- [ ] Human work is sequential. The real power of a browser agent comes into reality if we can parallelize similar tasks. For example, if you want to find contact information for 100 companies, this can all be done in parallel and reported back to a main agent, which processes the results and kicks off parallel subtasks again.## Contributing