| Name | browser-use-py310 JSON |
| Version |
0.1.40
JSON |
| download |
| home_page | None |
| Summary | Make websites accessible for AI agents |
| upload_time | 2025-02-25 09:08:10 |
| maintainer | None |
| docs_url | None |
| author | Gregor Zunic |
| requires_python | <4.0,>=3.10 |
| license | None |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./static/browser-use-dark.png">
<source media="(prefers-color-scheme: light)" srcset="./static/browser-use.png">
<img alt="Shows a black Browser Use Logo in light color mode and a white one in dark color mode." src="./static/browser-use.png" width="full">
</picture>
<h1 align="center">Enable AI to control your browser 🤖</h1>
[](https://github.com/gregpr07/browser-use/stargazers)
[](https://link.browser-use.com/discord)
[](https://docs.browser-use.com)
[](https://cloud.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) - we'd love to see what you create!
🌩️ Skip the setup - try our hosted version for instant browser automation! [Try it now](https://cloud.browser-use.com).
# Quick start
With pip (Python>=3.11):
```bash
pip install browser-use
```
install playwright:
```bash
playwright install
```
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="Go to Reddit, search for 'browser-use', click on the first post and return the first comment.",
llm=ChatOpenAI(model="gpt-4o"),
)
result = await agent.run()
print(result)
asyncio.run(main())
```
Add your API keys for the provider you want to use to your `.env` file.
```bash
OPENAI_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
<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.
# 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 workfows 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).
## 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:tbiddle@loop11.com?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.
## 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}
}
```
<div align="center"> <img src="https://github.com/user-attachments/assets/402b2129-b6ac-44d3-a217-01aea3277dce" width="400"/>
[](https://x.com/gregpr07)
[](https://x.com/mamagnus00)
</div>
<div align="center">
Made with ❤️ in Zurich and San Francisco
</div>
Raw data
{
"_id": null,
"home_page": null,
"name": "browser-use-py310",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Gregor Zunic",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/8b/07/b53a3acb277d08c2ddfaf83df190c37b5e9bf0d7cbee87a83e0ebe39cf7b/browser_use_py310-0.1.40.tar.gz",
"platform": null,
"description": "<picture>\n <source media=\"(prefers-color-scheme: dark)\" srcset=\"./static/browser-use-dark.png\">\n <source media=\"(prefers-color-scheme: light)\" srcset=\"./static/browser-use.png\">\n <img alt=\"Shows a black Browser Use Logo in light color mode and a white one in dark color mode.\" src=\"./static/browser-use.png\" width=\"full\">\n</picture>\n\n<h1 align=\"center\">Enable AI to control your browser \ud83e\udd16</h1>\n\n[](https://github.com/gregpr07/browser-use/stargazers)\n[](https://link.browser-use.com/discord)\n[](https://docs.browser-use.com)\n[](https://cloud.browser-use.com)\n[](https://x.com/gregpr07)\n[](https://x.com/mamagnus00)\n[](https://app.workweave.ai/reports/repository/org_T5Pvn3UBswTHIsN1dWS3voPg/881458615)\n\n\n\ud83c\udf10 Browser-use is the easiest way to connect your AI agents with the browser. \n\n\ud83d\udca1 See what others are building and share your projects in our [Discord](https://link.browser-use.com/discord) - we'd love to see what you create!\n\n\ud83c\udf29\ufe0f Skip the setup - try our hosted version for instant browser automation! [Try it now](https://cloud.browser-use.com).\n\n\n# Quick start\n\n\nWith pip (Python>=3.11):\n\n```bash\npip install browser-use\n```\n\ninstall playwright:\n\n```bash\nplaywright install\n```\n\nSpin up your agent:\n\n```python\nfrom langchain_openai import ChatOpenAI\nfrom browser_use import Agent\nimport asyncio\nfrom dotenv import load_dotenv\nload_dotenv()\n\nasync def main():\n agent = Agent(\n task=\"Go to Reddit, search for 'browser-use', click on the first post and return the first comment.\",\n llm=ChatOpenAI(model=\"gpt-4o\"),\n )\n result = await agent.run()\n print(result)\n\nasyncio.run(main())\n```\n\nAdd your API keys for the provider you want to use to your `.env` file.\n\n```bash\nOPENAI_API_KEY=\n```\n\nFor other settings, models, and more, check out the [documentation \ud83d\udcd5](https://docs.browser-use.com).\n\n\n### Test with UI\n\nYou can test [browser-use with a UI repository](https://github.com/browser-use/web-ui)\n\nOr simply run the gradio example:\n\n```\nuv pip install gradio\n```\n\n```bash\npython examples/ui/gradio_demo.py\n```\n\n# Demos\n\n\n\n\n\n\n\n<br/><br/>\n\n[Task](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/shopping.py): Add grocery items to cart, and checkout.\n\n[](https://www.youtube.com/watch?v=L2Ya9PYNns8)\n\n\n<br/><br/>\n\n\nPrompt: Add my latest LinkedIn follower to my leads in Salesforce.\n\n\n\n<br/><br/>\n\n[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.'\n\nhttps://github.com/user-attachments/assets/171fb4d6-0355-46f2-863e-edb04a828d04\n\n<br/><br/>\n\n[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.\n\n\n\n<br/><br/>\n\n[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.\n\nhttps://github.com/user-attachments/assets/de73ee39-432c-4b97-b4e8-939fd7f323b3\n\n\n<br/><br/>\n\n\n## More examples\n\nFor more examples see the [examples](examples) folder or join the [Discord](https://link.browser-use.com/discord) and show off your project.\n\n# Vision\n\nTell your computer what to do, and it gets it done.\n\n## Roadmap\n\n### Agent\n- [ ] Improve agent memory (summarize, compress, RAG, etc.)\n- [ ] Enhance planning capabilities (load website specific context)\n- [ ] Reduce token consumption (system prompt, DOM state)\n\n### DOM Extraction\n- [ ] Improve extraction for datepickers, dropdowns, special elements\n- [ ] Improve state representation for UI elements\n\n### Rerunning tasks\n- [ ] LLM as fallback\n- [ ] Make it easy to define workfows templates where LLM fills in the details\n- [ ] Return playwright script from the agent\n\n### Datasets\n- [ ] Create datasets for complex tasks\n- [ ] Benchmark various models against each other\n- [ ] Fine-tuning models for specific tasks\n\n### User Experience\n- [ ] Human-in-the-loop execution\n- [ ] Improve the generated GIF quality\n- [ ] Create various demos for tutorial execution, job application, QA testing, social media, etc.\n\n## Contributing\n\nWe love contributions! Feel free to open issues for bugs or feature requests. To contribute to the docs, check out the `/docs` folder.\n\n## Local Setup\n\nTo learn more about the library, check out the [local setup \ud83d\udcd5](https://docs.browser-use.com/development/local-setup).\n\n## Cooperations\n\nWe are forming a commission to define best practices for UI/UX design for browser agents.\nTogether, 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.\n\nEmail [Toby](mailto:tbiddle@loop11.com?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.\n## Citation\n\nIf you use Browser Use in your research or project, please cite:\n\n\n \n```bibtex\n@software{browser_use2024,\n author = {M\u00fcller, Magnus and \u017duni\u010d, Gregor},\n title = {Browser Use: Enable AI to control your browser},\n year = {2024},\n publisher = {GitHub},\n url = {https://github.com/browser-use/browser-use}\n}\n```\n \n\n\n <div align=\"center\"> <img src=\"https://github.com/user-attachments/assets/402b2129-b6ac-44d3-a217-01aea3277dce\" width=\"400\"/> \n \n[](https://x.com/gregpr07)\n[](https://x.com/mamagnus00)\n \n </div> \n\n<div align=\"center\">\nMade with \u2764\ufe0f in Zurich and San Francisco\n </div> \n\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Make websites accessible for AI agents",
"version": "0.1.40",
"project_urls": {
"Repository": "https://github.com/changsi/browser-use"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "68514ccfe949018cd9c72c99af9f073e840f2eaeec6895f5f3e66c9161303206",
"md5": "0b964050d7a7a10c8d9d817b5e11b67e",
"sha256": "da4c14ddd7538ea6dab01e26b76d3798c58711eec62bee449ac08c9cb9f90229"
},
"downloads": -1,
"filename": "browser_use_py310-0.1.40-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0b964050d7a7a10c8d9d817b5e11b67e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 86147,
"upload_time": "2025-02-25T09:08:08",
"upload_time_iso_8601": "2025-02-25T09:08:08.984025Z",
"url": "https://files.pythonhosted.org/packages/68/51/4ccfe949018cd9c72c99af9f073e840f2eaeec6895f5f3e66c9161303206/browser_use_py310-0.1.40-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8b07b53a3acb277d08c2ddfaf83df190c37b5e9bf0d7cbee87a83e0ebe39cf7b",
"md5": "b0160de51686e357e356df6c2ae4e701",
"sha256": "a6b70120747a43da24bd4621104af78ff8a0427857b75294ab9caa90d84cd96d"
},
"downloads": -1,
"filename": "browser_use_py310-0.1.40.tar.gz",
"has_sig": false,
"md5_digest": "b0160de51686e357e356df6c2ae4e701",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 1293997,
"upload_time": "2025-02-25T09:08:10",
"upload_time_iso_8601": "2025-02-25T09:08:10.618046Z",
"url": "https://files.pythonhosted.org/packages/8b/07/b53a3acb277d08c2ddfaf83df190c37b5e9bf0d7cbee87a83e0ebe39cf7b/browser_use_py310-0.1.40.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-25 09:08:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "changsi",
"github_project": "browser-use",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "browser-use-py310"
}
