{"id":26229619,"url":"https://github.com/erickrus/camel_ai_browser_use","last_synced_at":"2026-02-21T15:01:56.814Z","repository":{"id":279911500,"uuid":"940409958","full_name":"Erickrus/camel_ai_browser_use","owner":"Erickrus","description":"A tool to extend camelai's plans and thoughts to browser-use web automation","archived":false,"fork":false,"pushed_at":"2025-03-04T13:25:46.000Z","size":35,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T11:51:45.417Z","etag":null,"topics":["agent","browser-use","camel-ai","tools-and-automation"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Erickrus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-28T05:57:30.000Z","updated_at":"2025-03-12T21:15:51.000Z","dependencies_parsed_at":"2025-02-28T13:25:31.881Z","dependency_job_id":"15d8618b-1619-4d0f-9781-8fec98a2077e","html_url":"https://github.com/Erickrus/camel_ai_browser_use","commit_stats":null,"previous_names":["erickrus/camel_ai_browser_use"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erickrus%2Fcamel_ai_browser_use","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erickrus%2Fcamel_ai_browser_use/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erickrus%2Fcamel_ai_browser_use/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erickrus%2Fcamel_ai_browser_use/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Erickrus","download_url":"https://codeload.github.com/Erickrus/camel_ai_browser_use/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249770069,"owners_count":21323067,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","browser-use","camel-ai","tools-and-automation"],"created_at":"2025-03-12T22:17:07.117Z","updated_at":"2026-02-21T15:01:51.793Z","avatar_url":"https://github.com/Erickrus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# camel_ai_browser_use\n\n## Overview\nWith the rise of Large Language Models (LLMs), AI agents are transforming productivity across various fields. Typically seen as standalone tools, these agents can achieve even more when working together. This repository explores the collaboration between two distinct agents: the [CamelAI](https://github.com/camel-ai/camel/) Framework, which excels in generation and planning, and the [Browser Use](https://github.com/browser-use/browser-use), specialized in GUI-based automation tasks. By connecting their strengths, we can create a powerful synergy where one agent's capabilities complement the other's limitations. This initial trial demonstrates how heterogeneous agents can work together seamlessly, unlocking new possibilities for complex tasks that require both creativity and precision.\n\n## 1. Browser Use Toolkit \nBrowserUseToolkit (`browser_use_toolkit.py`) is a standard CamelAI toolkit implementation. It should be installed in CamelAI agent projects. This tool receives an instruction and sends it to the browser-use agent. Since GUI automation tasks can take a fairly long time, it submits the task and performs rolling polling to check if the task has finished and produced results.\n\n## 2. Browser Use Service\nBrowserUseService (`browser_use_service.py`) is the backend component responsible for executing web automation task. The service can only work on one specific task at a time. If other tasks are submitted, they will be pending until the current task is finished. \n\n```mermaid\nsequenceDiagram\n    participant CamelAI_Agent as CamelAI Agent\n    participant BrowserUseService as Browser Use Service\n    participant BrowserUseAgent as Browser Use Agent\n\n    CamelAI_Agent-\u003e\u003eBrowserUseService: Submit Task with Instructions\n    BrowserUseService--\u003e\u003eCamelAI_Agent: Return task_id\n\n    BrowserUseService-\u003e\u003eBrowserUseAgent: Submit Task for Automation\n    loop Every 2 seconds\n        CamelAI_Agent-\u003e\u003eBrowserUseService: Query Status with task_id\n        alt Task is not completed\n            BrowserUseService--\u003e\u003eCamelAI_Agent: Status: In Progress\n        else Task is completed\n            BrowserUseAgent--\u003e\u003eBrowserUseService: Return Results\n            BrowserUseService--\u003e\u003eCamelAI_Agent: Status: Completed\n            BrowserUseService--\u003e\u003eCamelAI_Agent: Return Results\n        end\n    end\n```\n\n### Customization\n\nYou may need do some customization by yourself, to set up .env file, the browser configuration etc. The service default port is `4999`. Following is an example `.env` file of `browser_use_service.py`. Place them in the same folder. \n```\nOPENAI_API_KEY=\u003cYOUR_OPENAI_API_KEY\u003e\nMODEL_NAME=gpt-4o-mini\nUSERNAME=user\nPASSWORD=password\n```\n\nHere, `USERNAME` and `PASSWORD` are sensitive_data will be passed to BrowserUse Agent.\n```python\nsensitive_data = {\n    'x_name': os.environ['USERNAME'],\n    'x_password': os.environ['PASSWORD']\n}\n```\n\n### BrowserUse Installation\n\nPlease refer to the [Browser Use](https://github.com/browser-use/browser-use) page.\n\nWith pip (Python\u003e=3.11):\n\n```bash\npip install browser-use\n```\n\ninstall playwright:\n\n```bash\nplaywright install\n```\n\n\n\n## 3. CamelAI Agent Demo Code\nThe code (`gui_agent.py`) demonstrates how to use the toolkit. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferickrus%2Fcamel_ai_browser_use","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferickrus%2Fcamel_ai_browser_use","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferickrus%2Fcamel_ai_browser_use/lists"}