https://github.com/browser-use/browser-use
π Make websites accessible for AI agents. Automate tasks online with ease.
https://github.com/browser-use/browser-use
ai-agents ai-tools browser-automation browser-use llm playwright python
Last synced: 15 days ago
JSON representation
π Make websites accessible for AI agents. Automate tasks online with ease.
- Host: GitHub
- URL: https://github.com/browser-use/browser-use
- Owner: browser-use
- License: mit
- Created: 2024-10-31T16:00:56.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-05-12T15:24:51.000Z (15 days ago)
- Last Synced: 2025-05-12T15:56:20.827Z (15 days ago)
- Topics: ai-agents, ai-tools, browser-automation, browser-use, llm, playwright, python
- Language: Python
- Homepage: https://browser-use.com
- Size: 9.27 MB
- Stars: 59,826
- Watchers: 347
- Forks: 6,560
- Open Issues: 430
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome - browser-use/browser-use - π Make websites accessible for AI agents. Automate tasks online with ease. (Python)
- awesome-LangGraph - Browser Use: Web AI - use/browser-use) (Community Projects / Development & Tools)
- awesome-ChatGPT-repositories - browser-use - Make websites accessible for AI agents (Browser-extensions)
- awesomeLibrary - browser-use - Make websites accessible for AI agents (θ―θ¨θ΅ζΊεΊ / python)
- awesome-generative-ai-data-scientist - Browser-Use
- awesome - browser-use/browser-use - π Make websites accessible for AI agents. Automate tasks online with ease. (Python)
- acu - Browser Use
- awesome-ui-agents - code
- AiTreasureBox - browser-use/browser-use - 05-13_59888_34](https://img.shields.io/github/stars/browser-use/browser-use.svg)|Make websites accessible for AI agents| (Repos)
- awesome-ccamel - browser-use/browser-use - Make websites accessible for AI agents (Python)
- awesome-safety-critical-ai - `browser-use/browser-use`
- awesome-hacking-lists - browser-use/browser-use - Make websites accessible for AI agents (Python)
- definitive-opensource - Browser Use
- Awesome-LLMOps - Browser Use - use/browser-use.svg?style=flat&color=green)   (Orchestration / Tools)
README
Enable AI to control your browser π€
[](https://github.com/gregpr07/browser-use/stargazers)
[](https://link.browser-use.com/discord)
[](https://cloud.browser-use.com)
[](https://docs.browser-use.com)
[](https://x.com/gregpr07)
[](https://x.com/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 hosted version for instant browser automation! [Try the cloud βοΈ](https://cloud.browser-use.com).
# Quick start
With pip (Python>=3.11):
```bash
pip install browser-use
```
For memory functionality (requires Python<3.13 due to PyTorch compatibility):
```bash
pip install "browser-use[memory]"
```
Install the browser:
```bash
playwright install chromium --with-deps --no-shell
```
Spin up your agent:
```python
from langchain_openai import ChatOpenAI
from browser_use import Agent
import asyncio
from dotenv import load_dotenv
load_dotenv()
async def main():
agent = Agent(
task="Compare the price of gpt-4o and DeepSeek-V3",
llm=ChatOpenAI(model="gpt-4o"),
)
await agent.run()
asyncio.run(main())
```
Add your API keys for the provider you want to use to your `.env` file.
```bash
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_KEY=
GEMINI_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
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).
### Test with an interactive CLI
You can also use our interactive CLI (similar to `claude` code):
```bash
$ browser-use
```
# 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)
Prompt: Add my latest LinkedIn follower to my leads in Salesforce.
[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
[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.
[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
## 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
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)
- [ ] 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
### 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
We love contributions! Feel free to open issues for bugs or feature requests. To contribute to the docs, check out the `/docs` folder.
## Local Setup
To learn more about the library, check out the [local setup π](https://docs.browser-use.com/development/local-setup).
`main` is the primary development branch with frequent changes. For production use, install a stable [versioned release](https://github.com/browser-use/browser-use/releases) instead.
---
## Swag
Want to show off your Browser-use swag? Check out our [Merch store](https://browsermerch.com). Good contributors will receive swag for free π.
## Citation
If you use Browser Use in your research or project, please cite:
```bibtex
@software{browser_use2024,
author = {MΓΌller, Magnus and Ε½uniΔ, Gregor},
title = {Browser Use: Enable AI to control your browser},
year = {2024},
publisher = {GitHub},
url = {https://github.com/browser-use/browser-use}
}
```
[](https://x.com/gregpr07)
[](https://x.com/mamagnus00)
Made with β€οΈ in Zurich and San Francisco