https://github.com/browser-use/browser-use
Make websites accessible for AI agents
https://github.com/browser-use/browser-use
ai-agents ai-tools browser-automation browser-use llm playwright python
Last synced: 7 days ago
JSON representation
Make websites accessible for AI agents
- Host: GitHub
- URL: https://github.com/browser-use/browser-use
- Owner: browser-use
- License: mit
- Created: 2024-10-31T16:00:56.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-01T17:11:10.000Z (14 days ago)
- Last Synced: 2025-04-01T21:01:25.540Z (14 days ago)
- Topics: ai-agents, ai-tools, browser-automation, browser-use, llm, playwright, python
- Language: Python
- Homepage: https://browser-use.com
- Size: 8.27 MB
- Stars: 51,227
- Watchers: 310
- Forks: 5,407
- Open Issues: 395
-
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 (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 (Python)
- acu - Browser Use
- awesome-ui-agents - code
- AiTreasureBox - browser-use/browser-use - 04-07_53853_336](https://img.shields.io/github/stars/browser-use/browser-use.svg)|Make websites accessible for AI agents| (Repos)
- Awesome-LLMOps - Browser Use - use/browser-use.svg?style=flat&color=green)   (Agent / Tools)
- 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)
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
```
Install Playwright:
```bash
playwright install chromium
```
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_ENDPOINT=
AZURE_OPENAI_API_KEY=
GEMINI_API_KEY=
DEEPSEEK_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 with a UI repository](https://github.com/browser-use/web-ui)
Or simply run the gradio example:
```
uv pip install gradio
```
```bash
python examples/ui/gradio_demo.py
```
# 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.
# Vision
Tell your computer what to do, and it gets it done.
## Roadmap
### Agent
- [ ] Improve agent memory (summarize, compress, RAG, etc.)
- [ ] Enhance planning capabilities (load website specific context)
- [ ] Reduce token consumption (system prompt, DOM state)
### DOM Extraction
- [ ] Improve extraction for datepickers, dropdowns, special elements
- [ ] Improve state representation for UI elements
### Rerunning tasks
- [ ] LLM as fallback
- [ ] Make it easy to define workflow templates where LLM fills in the details
- [ ] Return playwright script from the agent
### Datasets
- [ ] Create datasets for complex tasks
- [ ] Benchmark various models against each other
- [ ] Fine-tuning models for specific tasks
### User Experience
- [ ] Human-in-the-loop execution
- [ ] Improve the generated GIF quality
- [ ] Create various demos for tutorial execution, job application, QA testing, social media, etc.
## 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.
---
## Cooperations
We are forming a commission to define best practices for UI/UX design for browser agents.
Together, we're exploring how software redesign improves the performance of AI agents and gives these companies a competitive advantage by designing their existing software to be at the forefront of the agent age.
Email [Toby](mailto:[email protected]?subject=I%20want%20to%20join%20the%20UI/UX%20commission%20for%20AI%20agents&body=Hi%20Toby%2C%0A%0AI%20found%20you%20in%20the%20browser-use%20GitHub%20README.%0A%0A) to apply for a seat on the committee.
## 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