optexity-browser-use 0.9.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (147) hide show
  1. optexity_browser_use-0.9.5/.gitignore +84 -0
  2. optexity_browser_use-0.9.5/LICENSE +21 -0
  3. optexity_browser_use-0.9.5/PKG-INFO +344 -0
  4. optexity_browser_use-0.9.5/README.md +267 -0
  5. optexity_browser_use-0.9.5/browser_use/__init__.py +157 -0
  6. optexity_browser_use-0.9.5/browser_use/actor/__init__.py +11 -0
  7. optexity_browser_use-0.9.5/browser_use/actor/element.py +1175 -0
  8. optexity_browser_use-0.9.5/browser_use/actor/mouse.py +134 -0
  9. optexity_browser_use-0.9.5/browser_use/actor/page.py +561 -0
  10. optexity_browser_use-0.9.5/browser_use/actor/playground/flights.py +41 -0
  11. optexity_browser_use-0.9.5/browser_use/actor/playground/mixed_automation.py +54 -0
  12. optexity_browser_use-0.9.5/browser_use/actor/playground/playground.py +236 -0
  13. optexity_browser_use-0.9.5/browser_use/actor/utils.py +176 -0
  14. optexity_browser_use-0.9.5/browser_use/agent/cloud_events.py +282 -0
  15. optexity_browser_use-0.9.5/browser_use/agent/gif.py +424 -0
  16. optexity_browser_use-0.9.5/browser_use/agent/judge.py +170 -0
  17. optexity_browser_use-0.9.5/browser_use/agent/message_manager/service.py +473 -0
  18. optexity_browser_use-0.9.5/browser_use/agent/message_manager/utils.py +52 -0
  19. optexity_browser_use-0.9.5/browser_use/agent/message_manager/views.py +98 -0
  20. optexity_browser_use-0.9.5/browser_use/agent/prompts.py +413 -0
  21. optexity_browser_use-0.9.5/browser_use/agent/service.py +2316 -0
  22. optexity_browser_use-0.9.5/browser_use/agent/system_prompt.md +185 -0
  23. optexity_browser_use-0.9.5/browser_use/agent/system_prompt_flash.md +10 -0
  24. optexity_browser_use-0.9.5/browser_use/agent/system_prompt_no_thinking.md +183 -0
  25. optexity_browser_use-0.9.5/browser_use/agent/views.py +743 -0
  26. optexity_browser_use-0.9.5/browser_use/browser/__init__.py +41 -0
  27. optexity_browser_use-0.9.5/browser_use/browser/cloud/cloud.py +203 -0
  28. optexity_browser_use-0.9.5/browser_use/browser/cloud/views.py +89 -0
  29. optexity_browser_use-0.9.5/browser_use/browser/events.py +578 -0
  30. optexity_browser_use-0.9.5/browser_use/browser/profile.py +1158 -0
  31. optexity_browser_use-0.9.5/browser_use/browser/python_highlights.py +548 -0
  32. optexity_browser_use-0.9.5/browser_use/browser/session.py +3225 -0
  33. optexity_browser_use-0.9.5/browser_use/browser/session_manager.py +399 -0
  34. optexity_browser_use-0.9.5/browser_use/browser/video_recorder.py +162 -0
  35. optexity_browser_use-0.9.5/browser_use/browser/views.py +200 -0
  36. optexity_browser_use-0.9.5/browser_use/browser/watchdog_base.py +260 -0
  37. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/__init__.py +0 -0
  38. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/aboutblank_watchdog.py +253 -0
  39. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/crash_watchdog.py +335 -0
  40. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/default_action_watchdog.py +2729 -0
  41. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/dom_watchdog.py +817 -0
  42. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/downloads_watchdog.py +1277 -0
  43. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/local_browser_watchdog.py +461 -0
  44. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/permissions_watchdog.py +43 -0
  45. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/popups_watchdog.py +143 -0
  46. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/recording_watchdog.py +126 -0
  47. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/screenshot_watchdog.py +62 -0
  48. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/security_watchdog.py +280 -0
  49. optexity_browser_use-0.9.5/browser_use/browser/watchdogs/storage_state_watchdog.py +335 -0
  50. optexity_browser_use-0.9.5/browser_use/cli.py +2359 -0
  51. optexity_browser_use-0.9.5/browser_use/code_use/__init__.py +16 -0
  52. optexity_browser_use-0.9.5/browser_use/code_use/formatting.py +192 -0
  53. optexity_browser_use-0.9.5/browser_use/code_use/namespace.py +665 -0
  54. optexity_browser_use-0.9.5/browser_use/code_use/notebook_export.py +276 -0
  55. optexity_browser_use-0.9.5/browser_use/code_use/service.py +1340 -0
  56. optexity_browser_use-0.9.5/browser_use/code_use/system_prompt.md +574 -0
  57. optexity_browser_use-0.9.5/browser_use/code_use/utils.py +150 -0
  58. optexity_browser_use-0.9.5/browser_use/code_use/views.py +171 -0
  59. optexity_browser_use-0.9.5/browser_use/config.py +505 -0
  60. optexity_browser_use-0.9.5/browser_use/controller/__init__.py +3 -0
  61. optexity_browser_use-0.9.5/browser_use/dom/enhanced_snapshot.py +161 -0
  62. optexity_browser_use-0.9.5/browser_use/dom/markdown_extractor.py +169 -0
  63. optexity_browser_use-0.9.5/browser_use/dom/playground/extraction.py +312 -0
  64. optexity_browser_use-0.9.5/browser_use/dom/playground/multi_act.py +32 -0
  65. optexity_browser_use-0.9.5/browser_use/dom/serializer/clickable_elements.py +200 -0
  66. optexity_browser_use-0.9.5/browser_use/dom/serializer/code_use_serializer.py +287 -0
  67. optexity_browser_use-0.9.5/browser_use/dom/serializer/eval_serializer.py +478 -0
  68. optexity_browser_use-0.9.5/browser_use/dom/serializer/html_serializer.py +212 -0
  69. optexity_browser_use-0.9.5/browser_use/dom/serializer/paint_order.py +197 -0
  70. optexity_browser_use-0.9.5/browser_use/dom/serializer/serializer.py +1170 -0
  71. optexity_browser_use-0.9.5/browser_use/dom/service.py +825 -0
  72. optexity_browser_use-0.9.5/browser_use/dom/utils.py +129 -0
  73. optexity_browser_use-0.9.5/browser_use/dom/views.py +906 -0
  74. optexity_browser_use-0.9.5/browser_use/exceptions.py +5 -0
  75. optexity_browser_use-0.9.5/browser_use/filesystem/__init__.py +0 -0
  76. optexity_browser_use-0.9.5/browser_use/filesystem/file_system.py +619 -0
  77. optexity_browser_use-0.9.5/browser_use/init_cmd.py +376 -0
  78. optexity_browser_use-0.9.5/browser_use/integrations/gmail/__init__.py +24 -0
  79. optexity_browser_use-0.9.5/browser_use/integrations/gmail/actions.py +115 -0
  80. optexity_browser_use-0.9.5/browser_use/integrations/gmail/service.py +225 -0
  81. optexity_browser_use-0.9.5/browser_use/llm/__init__.py +155 -0
  82. optexity_browser_use-0.9.5/browser_use/llm/anthropic/chat.py +242 -0
  83. optexity_browser_use-0.9.5/browser_use/llm/anthropic/serializer.py +312 -0
  84. optexity_browser_use-0.9.5/browser_use/llm/aws/__init__.py +36 -0
  85. optexity_browser_use-0.9.5/browser_use/llm/aws/chat_anthropic.py +242 -0
  86. optexity_browser_use-0.9.5/browser_use/llm/aws/chat_bedrock.py +289 -0
  87. optexity_browser_use-0.9.5/browser_use/llm/aws/serializer.py +257 -0
  88. optexity_browser_use-0.9.5/browser_use/llm/azure/chat.py +91 -0
  89. optexity_browser_use-0.9.5/browser_use/llm/base.py +57 -0
  90. optexity_browser_use-0.9.5/browser_use/llm/browser_use/__init__.py +3 -0
  91. optexity_browser_use-0.9.5/browser_use/llm/browser_use/chat.py +201 -0
  92. optexity_browser_use-0.9.5/browser_use/llm/cerebras/chat.py +193 -0
  93. optexity_browser_use-0.9.5/browser_use/llm/cerebras/serializer.py +109 -0
  94. optexity_browser_use-0.9.5/browser_use/llm/deepseek/chat.py +212 -0
  95. optexity_browser_use-0.9.5/browser_use/llm/deepseek/serializer.py +109 -0
  96. optexity_browser_use-0.9.5/browser_use/llm/exceptions.py +29 -0
  97. optexity_browser_use-0.9.5/browser_use/llm/google/__init__.py +3 -0
  98. optexity_browser_use-0.9.5/browser_use/llm/google/chat.py +542 -0
  99. optexity_browser_use-0.9.5/browser_use/llm/google/serializer.py +120 -0
  100. optexity_browser_use-0.9.5/browser_use/llm/groq/chat.py +229 -0
  101. optexity_browser_use-0.9.5/browser_use/llm/groq/parser.py +158 -0
  102. optexity_browser_use-0.9.5/browser_use/llm/groq/serializer.py +159 -0
  103. optexity_browser_use-0.9.5/browser_use/llm/messages.py +238 -0
  104. optexity_browser_use-0.9.5/browser_use/llm/models.py +271 -0
  105. optexity_browser_use-0.9.5/browser_use/llm/oci_raw/__init__.py +10 -0
  106. optexity_browser_use-0.9.5/browser_use/llm/oci_raw/chat.py +443 -0
  107. optexity_browser_use-0.9.5/browser_use/llm/oci_raw/serializer.py +229 -0
  108. optexity_browser_use-0.9.5/browser_use/llm/ollama/chat.py +97 -0
  109. optexity_browser_use-0.9.5/browser_use/llm/ollama/serializer.py +143 -0
  110. optexity_browser_use-0.9.5/browser_use/llm/openai/chat.py +264 -0
  111. optexity_browser_use-0.9.5/browser_use/llm/openai/like.py +15 -0
  112. optexity_browser_use-0.9.5/browser_use/llm/openai/serializer.py +165 -0
  113. optexity_browser_use-0.9.5/browser_use/llm/openrouter/chat.py +211 -0
  114. optexity_browser_use-0.9.5/browser_use/llm/openrouter/serializer.py +26 -0
  115. optexity_browser_use-0.9.5/browser_use/llm/schema.py +176 -0
  116. optexity_browser_use-0.9.5/browser_use/llm/views.py +48 -0
  117. optexity_browser_use-0.9.5/browser_use/logging_config.py +330 -0
  118. optexity_browser_use-0.9.5/browser_use/mcp/__init__.py +18 -0
  119. optexity_browser_use-0.9.5/browser_use/mcp/__main__.py +12 -0
  120. optexity_browser_use-0.9.5/browser_use/mcp/client.py +544 -0
  121. optexity_browser_use-0.9.5/browser_use/mcp/controller.py +264 -0
  122. optexity_browser_use-0.9.5/browser_use/mcp/server.py +1114 -0
  123. optexity_browser_use-0.9.5/browser_use/observability.py +204 -0
  124. optexity_browser_use-0.9.5/browser_use/py.typed +0 -0
  125. optexity_browser_use-0.9.5/browser_use/sandbox/__init__.py +41 -0
  126. optexity_browser_use-0.9.5/browser_use/sandbox/sandbox.py +637 -0
  127. optexity_browser_use-0.9.5/browser_use/sandbox/views.py +132 -0
  128. optexity_browser_use-0.9.5/browser_use/screenshots/__init__.py +1 -0
  129. optexity_browser_use-0.9.5/browser_use/screenshots/service.py +52 -0
  130. optexity_browser_use-0.9.5/browser_use/sync/__init__.py +6 -0
  131. optexity_browser_use-0.9.5/browser_use/sync/auth.py +357 -0
  132. optexity_browser_use-0.9.5/browser_use/sync/service.py +161 -0
  133. optexity_browser_use-0.9.5/browser_use/telemetry/__init__.py +51 -0
  134. optexity_browser_use-0.9.5/browser_use/telemetry/service.py +112 -0
  135. optexity_browser_use-0.9.5/browser_use/telemetry/views.py +101 -0
  136. optexity_browser_use-0.9.5/browser_use/tokens/__init__.py +0 -0
  137. optexity_browser_use-0.9.5/browser_use/tokens/custom_pricing.py +24 -0
  138. optexity_browser_use-0.9.5/browser_use/tokens/mappings.py +4 -0
  139. optexity_browser_use-0.9.5/browser_use/tokens/service.py +580 -0
  140. optexity_browser_use-0.9.5/browser_use/tokens/views.py +108 -0
  141. optexity_browser_use-0.9.5/browser_use/tools/registry/service.py +572 -0
  142. optexity_browser_use-0.9.5/browser_use/tools/registry/views.py +174 -0
  143. optexity_browser_use-0.9.5/browser_use/tools/service.py +1675 -0
  144. optexity_browser_use-0.9.5/browser_use/tools/utils.py +82 -0
  145. optexity_browser_use-0.9.5/browser_use/tools/views.py +100 -0
  146. optexity_browser_use-0.9.5/browser_use/utils.py +670 -0
  147. optexity_browser_use-0.9.5/pyproject.toml +223 -0
@@ -0,0 +1,84 @@
1
+ # Cache files
2
+ .DS_Store
3
+ __pycache__/
4
+ *.py[cod]
5
+ *$py.class
6
+ .mypy_cache/
7
+ .ruff_cache/
8
+ .pytest_cache/
9
+ .ipynb_checkpoints
10
+ ~/
11
+
12
+ # Virtual Environments
13
+ .venv*
14
+ venv/
15
+
16
+ # IDEs
17
+ .vscode/
18
+ .idea/
19
+
20
+ # Build files
21
+ dist/
22
+
23
+ # Data files
24
+ *.gif
25
+ *.txt
26
+ *.pdf
27
+ *.csv
28
+ *.json
29
+ *.jsonl
30
+ *.log
31
+ *.bak
32
+
33
+ # Secrets and sensitive files
34
+ secrets.env
35
+ .env
36
+ browser_cookies.json
37
+ cookies.json
38
+ gcp-login.json
39
+ saved_trajectories/
40
+ old_tests/
41
+ AgentHistory.json
42
+ AgentHistoryList.json
43
+ private_example.py
44
+ private_example
45
+ CLAUDE.local.md
46
+
47
+ uv.lock
48
+ temp
49
+ tmp
50
+
51
+ # Google API credentials
52
+ credentials.json
53
+ token.json
54
+
55
+ !docs/docs.json
56
+
57
+
58
+ temp-profile-*
59
+
60
+ screenshot.png
61
+
62
+ # *.md
63
+
64
+ all_github_issues_progress.md
65
+ all_github_issues.md
66
+
67
+ todo-input-token.md
68
+
69
+ TOOL_CHANGES_SUMMARY.md
70
+
71
+
72
+ claude-code-todo
73
+ result_judge.md
74
+ result.md
75
+ result2.md
76
+ result3.md
77
+ Brainstorm.md
78
+ example.ipynb
79
+ *SUMMARY.md
80
+ todo.md
81
+ product_extraction.ipynb
82
+ product_extraction.py
83
+ *report.md
84
+ plot.py
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024 Gregor Zunic
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,344 @@
1
+ Metadata-Version: 2.4
2
+ Name: optexity-browser-use
3
+ Version: 0.9.5
4
+ Summary: Make websites accessible for AI agents
5
+ Project-URL: Repository, https://github.com/browser-use/browser-use
6
+ Author: Gregor Zunic
7
+ License-File: LICENSE
8
+ Classifier: License :: OSI Approved :: MIT License
9
+ Classifier: Operating System :: OS Independent
10
+ Classifier: Programming Language :: Python :: 3
11
+ Requires-Python: <4.0,>=3.11
12
+ Requires-Dist: aiohttp==3.12.15
13
+ Requires-Dist: anthropic<1.0.0,>=0.68.1
14
+ Requires-Dist: anyio>=4.9.0
15
+ Requires-Dist: authlib>=1.6.0
16
+ Requires-Dist: bubus>=1.5.6
17
+ Requires-Dist: cdp-use>=1.4.0
18
+ Requires-Dist: click>=8.1.8
19
+ Requires-Dist: cloudpickle>=3.1.1
20
+ Requires-Dist: google-api-core>=2.25.0
21
+ Requires-Dist: google-api-python-client>=2.174.0
22
+ Requires-Dist: google-auth-oauthlib>=1.2.2
23
+ Requires-Dist: google-auth>=2.40.3
24
+ Requires-Dist: google-genai<2.0.0,>=1.29.0
25
+ Requires-Dist: groq>=0.30.0
26
+ Requires-Dist: httpx>=0.28.1
27
+ Requires-Dist: inquirerpy>=0.3.4
28
+ Requires-Dist: markdownify>=1.2.0
29
+ Requires-Dist: mcp>=1.10.1
30
+ Requires-Dist: ollama>=0.5.1
31
+ Requires-Dist: openai<2.0.0,>=1.99.2
32
+ Requires-Dist: pillow>=11.2.1
33
+ Requires-Dist: portalocker<3.0.0,>=2.7.0
34
+ Requires-Dist: posthog>=3.7.0
35
+ Requires-Dist: psutil>=7.0.0
36
+ Requires-Dist: pydantic>=2.11.5
37
+ Requires-Dist: pyobjc>=11.0; platform_system == 'darwin'
38
+ Requires-Dist: pyotp>=2.9.0
39
+ Requires-Dist: pypdf>=5.7.0
40
+ Requires-Dist: python-docx>=1.2.0
41
+ Requires-Dist: python-dotenv>=1.0.1
42
+ Requires-Dist: reportlab>=4.0.0
43
+ Requires-Dist: requests>=2.32.3
44
+ Requires-Dist: rich>=14.0.0
45
+ Requires-Dist: screeninfo>=0.8.1; platform_system != 'darwin'
46
+ Requires-Dist: typing-extensions>=4.12.2
47
+ Requires-Dist: uuid7>=0.1.0
48
+ Provides-Extra: all
49
+ Requires-Dist: browser-use[aws,cli,examples,oci]; extra == 'all'
50
+ Provides-Extra: aws
51
+ Requires-Dist: boto3>=1.38.45; extra == 'aws'
52
+ Provides-Extra: cli
53
+ Requires-Dist: textual>=3.2.0; extra == 'cli'
54
+ Provides-Extra: cli-oci
55
+ Requires-Dist: browser-use[cli,oci]; extra == 'cli-oci'
56
+ Provides-Extra: code
57
+ Requires-Dist: matplotlib>=3.9.0; extra == 'code'
58
+ Requires-Dist: numpy>=2.3.2; extra == 'code'
59
+ Requires-Dist: pandas>=2.2.0; extra == 'code'
60
+ Requires-Dist: tabulate>=0.9.0; extra == 'code'
61
+ Provides-Extra: eval
62
+ Requires-Dist: anyio>=4.9.0; extra == 'eval'
63
+ Requires-Dist: datamodel-code-generator>=0.26.0; extra == 'eval'
64
+ Requires-Dist: lmnr[all]==0.7.17; extra == 'eval'
65
+ Requires-Dist: psutil>=7.0.0; extra == 'eval'
66
+ Provides-Extra: examples
67
+ Requires-Dist: agentmail==0.0.59; extra == 'examples'
68
+ Requires-Dist: botocore>=1.37.23; extra == 'examples'
69
+ Requires-Dist: imgcat>=0.6.0; extra == 'examples'
70
+ Requires-Dist: langchain-openai>=0.3.26; extra == 'examples'
71
+ Provides-Extra: oci
72
+ Requires-Dist: oci>=2.126.4; extra == 'oci'
73
+ Provides-Extra: video
74
+ Requires-Dist: imageio[ffmpeg]>=2.37.0; extra == 'video'
75
+ Requires-Dist: numpy>=2.3.2; extra == 'video'
76
+ Description-Content-Type: text/markdown
77
+
78
+ <picture>
79
+ <source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/2ccdb752-22fb-41c7-8948-857fc1ad7e24"">
80
+ <source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/774a46d5-27a0-490c-b7d0-e65fcbbfa358">
81
+ <img alt="Shows a black Browser Use Logo in light color mode and a white one in dark color mode." src="https://github.com/user-attachments/assets/2ccdb752-22fb-41c7-8948-857fc1ad7e24" width="full">
82
+ </picture>
83
+
84
+ <div align="center">
85
+ <picture>
86
+ <source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/9955dda9-ede3-4971-8ee0-91cbc3850125"">
87
+ <source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/6797d09b-8ac3-4cb9-ba07-b289e080765a">
88
+ <img alt="The AI browser agent." src="https://github.com/user-attachments/assets/9955dda9-ede3-4971-8ee0-91cbc3850125" width="400">
89
+ </picture>
90
+ </div>
91
+
92
+ <div align="center">
93
+ <img src="https://media.browser-use.tools/badges/package" height="48" alt="Browser-Use Package Download Statistics">
94
+ </div>
95
+
96
+ ---
97
+
98
+ <div align="center">
99
+ <a href="#demos"><img src="https://media.browser-use.tools/badges/demos" alt="Demos"></a>
100
+ <img width="16" height="1" alt="">
101
+ <a href="https://docs.browser-use.com"><img src="https://media.browser-use.tools/badges/docs" alt="Docs"></a>
102
+ <img width="16" height="1" alt="">
103
+ <a href="https://browser-use.com/posts"><img src="https://media.browser-use.tools/badges/blog" alt="Blog"></a>
104
+ <img width="16" height="1" alt="">
105
+ <a href="https://browsermerch.com"><img src="https://media.browser-use.tools/badges/merch" alt="Merch"></a>
106
+ <img width="100" height="1" alt="">
107
+ <a href="https://github.com/browser-use/browser-use"><img src="https://media.browser-use.tools/badges/github" alt="Github Stars"></a>
108
+ <img width="4" height="1" alt="">
109
+ <a href="https://x.com/intent/user?screen_name=browser_use"><img src="https://media.browser-use.tools/badges/twitter" alt="Twitter"></a>
110
+ <img width="4 height="1" alt="">
111
+ <a href="https://link.browser-use.com/discord"><img src="https://media.browser-use.tools/badges/discord" alt="Discord"></a>
112
+ <img width="4" height="1" alt="">
113
+ <a href="https://cloud.browser-use.com"><img src="https://media.browser-use.tools/badges/cloud" height="48" alt="Browser-Use Cloud"></a>
114
+ </div>
115
+
116
+ </br>
117
+
118
+ # 🤖 LLM Quickstart
119
+
120
+ 1. Direct your favorite coding agent (Cursor, ClaudeS, etc) to [Agents.md](https://docs.browser-use.com/llms-full.txt)
121
+ 2. Prompt away!
122
+
123
+ <br/>
124
+
125
+ # 👋 Human Quickstart
126
+
127
+ **1. Create environment with [uv](https://docs.astral.sh/uv/) (Python>=3.11):**
128
+ ```bash
129
+ uv init
130
+ ```
131
+
132
+ **2. Install Browser-Use package:**
133
+ ```bash
134
+ # We ship every day - use the latest version!
135
+ uv add browser-use
136
+ uv sync
137
+ ```
138
+
139
+ **3. Get your API key from [Browser Use Cloud](https://cloud.browser-use.com/new-api-key) and add it to your `.env` file (new signups get $10 free credits):**
140
+ ```
141
+ # .env
142
+ BROWSER_USE_API_KEY=your-key
143
+ ```
144
+
145
+ **4. Install Chromium browser:**
146
+ ```bash
147
+ uvx browser-use install
148
+ ```
149
+
150
+ **5. Run your first agent:**
151
+ ```python
152
+ from browser_use import Agent, Browser, ChatBrowserUse
153
+ import asyncio
154
+
155
+ async def example():
156
+ browser = Browser(
157
+ # use_cloud=True, # Uncomment to use a stealth browser on Browser Use Cloud
158
+ )
159
+
160
+ llm = ChatBrowserUse()
161
+
162
+ agent = Agent(
163
+ task="Find the number of stars of the browser-use repo",
164
+ llm=llm,
165
+ browser=browser,
166
+ )
167
+
168
+ history = await agent.run()
169
+ return history
170
+
171
+ if __name__ == "__main__":
172
+ history = asyncio.run(example())
173
+ ```
174
+
175
+ Check out the [library docs](https://docs.browser-use.com) and the [cloud docs](https://docs.cloud.browser-use.com) for more!
176
+
177
+ <br/>
178
+
179
+ # 🔥 Deploy on Sandboxes
180
+
181
+ We handle agents, browsers, persistence, auth, cookies, and LLMs. The agent runs right next to the browser for minimal latency.
182
+
183
+ ```python
184
+ from browser_use import Browser, sandbox, ChatBrowserUse
185
+ from browser_use.agent.service import Agent
186
+ import asyncio
187
+
188
+ @sandbox()
189
+ async def my_task(browser: Browser):
190
+ agent = Agent(task="Find the top HN post", browser=browser, llm=ChatBrowserUse())
191
+ await agent.run()
192
+
193
+ # Just call it like any async function
194
+ asyncio.run(my_task())
195
+ ```
196
+
197
+ See [Going to Production](https://docs.browser-use.com/production) for more details.
198
+
199
+ <br/>
200
+
201
+ # 🚀 Template Quickstart
202
+
203
+ **Want to get started even faster?** Generate a ready-to-run template:
204
+
205
+ ```bash
206
+ uvx browser-use init --template default
207
+ ```
208
+
209
+ This creates a `browser_use_default.py` file with a working example. Available templates:
210
+ - `default` - Minimal setup to get started quickly
211
+ - `advanced` - All configuration options with detailed comments
212
+ - `tools` - Examples of custom tools and extending the agent
213
+
214
+ You can also specify a custom output path:
215
+ ```bash
216
+ uvx browser-use init --template default --output my_agent.py
217
+ ```
218
+
219
+ <br/>
220
+
221
+ # Demos
222
+
223
+
224
+ ### 📋 Form-Filling
225
+ #### Task = "Fill in this job application with my resume and information."
226
+ ![Job Application Demo](https://github.com/user-attachments/assets/57865ee6-6004-49d5-b2c2-6dff39ec2ba9)
227
+ [Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/apply_to_job.py)
228
+
229
+
230
+ ### 🍎 Grocery-Shopping
231
+ #### Task = "Put this list of items into my instacart."
232
+
233
+ https://github.com/user-attachments/assets/a6813fa7-4a7c-40a6-b4aa-382bf88b1850
234
+
235
+ [Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/buy_groceries.py)
236
+
237
+
238
+ ### 💻 Personal-Assistant.
239
+ #### Task = "Help me find parts for a custom PC."
240
+
241
+ https://github.com/user-attachments/assets/ac34f75c-057a-43ef-ad06-5b2c9d42bf06
242
+
243
+ [Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/pcpartpicker.py)
244
+
245
+
246
+ ### 💡See [more examples here ↗](https://docs.browser-use.com/examples) and give us a star!
247
+
248
+ <br/>
249
+
250
+ ## Integrations, hosting, custom tools, MCP, and more on our [Docs ↗](https://docs.browser-use.com)
251
+
252
+ <br/>
253
+
254
+ # FAQ
255
+
256
+ <details>
257
+ <summary><b>What's the best model to use?</b></summary>
258
+
259
+ We optimized **ChatBrowserUse()** specifically for browser automation tasks. On avg it completes tasks 3-5x faster than other models with SOTA accuracy.
260
+
261
+ **Pricing (per 1M tokens):**
262
+ - Input tokens: $0.50
263
+ - Output tokens: $3.00
264
+ - Cached tokens: $0.10
265
+
266
+ For other LLM providers, see our [supported models documentation](https://docs.browser-use.com/supported-models).
267
+ </details>
268
+
269
+
270
+ <details>
271
+ <summary><b>Can I use custom tools with the agent?</b></summary>
272
+
273
+ Yes! You can add custom tools to extend the agent's capabilities:
274
+
275
+ ```python
276
+ from browser_use import Tools
277
+
278
+ tools = Tools()
279
+
280
+ @tools.action(description='Description of what this tool does.')
281
+ def custom_tool(param: str) -> str:
282
+ return f"Result: {param}"
283
+
284
+ agent = Agent(
285
+ task="Your task",
286
+ llm=llm,
287
+ browser=browser,
288
+ tools=tools,
289
+ )
290
+ ```
291
+
292
+ </details>
293
+
294
+ <details>
295
+ <summary><b>Can I use this for free?</b></summary>
296
+
297
+ 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).
298
+ </details>
299
+
300
+ <details>
301
+ <summary><b>How do I handle authentication?</b></summary>
302
+
303
+ Check out our authentication examples:
304
+ - [Using real browser profiles](https://github.com/browser-use/browser-use/blob/main/examples/browser/real_browser.py) - Reuse your existing Chrome profile with saved logins
305
+ - If you want to use temporary accounts with inbox, choose AgentMail
306
+ - To sync your auth profile with the remote browser, run `curl -fsSL https://browser-use.com/profile.sh | BROWSER_USE_API_KEY=XXXX sh` (replace XXXX with your API key)
307
+
308
+ These examples show how to maintain sessions and handle authentication seamlessly.
309
+ </details>
310
+
311
+ <details>
312
+ <summary><b>How do I solve CAPTCHAs?</b></summary>
313
+
314
+ 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.
315
+ </details>
316
+
317
+ <details>
318
+ <summary><b>How do I go into production?</b></summary>
319
+
320
+ Chrome can consume a lot of memory, and running many agents in parallel can be tricky to manage.
321
+
322
+ For production use cases, use our [Browser Use Cloud API](https://cloud.browser-use.com) which handles:
323
+ - Scalable browser infrastructure
324
+ - Memory management
325
+ - Proxy rotation
326
+ - Stealth browser fingerprinting
327
+ - High-performance parallel execution
328
+ </details>
329
+
330
+ <br/>
331
+
332
+ <div align="center">
333
+
334
+ **Tell your computer what to do, and it gets it done.**
335
+
336
+ <img src="https://github.com/user-attachments/assets/06fa3078-8461-4560-b434-445510c1766f" width="400"/>
337
+
338
+ [![Twitter Follow](https://img.shields.io/twitter/follow/Magnus?style=social)](https://x.com/intent/user?screen_name=mamagnus00)
339
+ &emsp;&emsp;&emsp;
340
+ [![Twitter Follow](https://img.shields.io/twitter/follow/Gregor?style=social)](https://x.com/intent/user?screen_name=gregpr07)
341
+
342
+ </div>
343
+
344
+ <div align="center"> Made with ❤️ in Zurich and San Francisco </div>