{"id":34612828,"url":"https://github.com/agent-network-protocol/owl_anp","last_synced_at":"2026-05-27T17:31:44.375Z","repository":{"id":281459365,"uuid":"945347545","full_name":"agent-network-protocol/owl_anp","owner":"agent-network-protocol","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-16T04:19:42.000Z","size":4717,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-26T03:05:08.576Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/agent-network-protocol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"licenses/LICENSE","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-03-09T07:43:30.000Z","updated_at":"2025-10-04T15:48:08.000Z","dependencies_parsed_at":"2025-03-09T08:36:59.664Z","dependency_job_id":null,"html_url":"https://github.com/agent-network-protocol/owl_anp","commit_stats":null,"previous_names":["agent-network-protocol/owl_anp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/agent-network-protocol/owl_anp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-network-protocol%2Fowl_anp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-network-protocol%2Fowl_anp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-network-protocol%2Fowl_anp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-network-protocol%2Fowl_anp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agent-network-protocol","download_url":"https://codeload.github.com/agent-network-protocol/owl_anp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-network-protocol%2Fowl_anp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33577632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-12-24T14:17:44.901Z","updated_at":"2026-05-27T17:31:44.369Z","avatar_url":"https://github.com/agent-network-protocol.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n\t🦉 OWL: Optimized Workforce Learning for General Multi-Agent Assistance in Real-World Task Automation\n\u003c/h1\u003e\n\n\n\u003cdiv align=\"center\"\u003e\n\n[![Documentation][docs-image]][docs-url]\n[![Discord][discord-image]][discord-url]\n[![X][x-image]][x-url]\n[![Reddit][reddit-image]][reddit-url]\n[![Wechat][wechat-image]][wechat-url]\n[![Wechat][owl-image]][owl-url]\n[![Hugging Face][huggingface-image]][huggingface-url]\n[![Star][star-image]][star-url]\n[![Package License][package-license-image]][package-license-url]\n\n\n\u003c/div\u003e\n\n\n\u003chr\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003ch4 align=\"center\"\u003e\n\n[中文阅读](https://github.com/camel-ai/owl/tree/main/README_zh.md) |\n[Community](https://github.com/camel-ai/owl#community) |\n[Installation](#️-installation) |\n[Examples](https://github.com/camel-ai/owl/tree/main/owl) |\n[Paper](https://arxiv.org/abs/2303.17760) |\n[Citation](https://github.com/camel-ai/owl#citation) |\n[Contributing](https://github.com/camel-ai/owl/graphs/contributors) |\n[CAMEL-AI](https://www.camel-ai.org/)\n\n\u003c/h4\u003e\n\n\u003cdiv align=\"center\" style=\"background-color: #f0f7ff; padding: 10px; border-radius: 5px; margin: 15px 0;\"\u003e\n  \u003ch3 style=\"color: #1e88e5; margin: 0;\"\u003e\n    🏆 OWL achieves \u003cspan style=\"color: #d81b60; font-weight: bold; font-size: 1.2em;\"\u003e58.18\u003c/span\u003e average score on GAIA benchmark and ranks \u003cspan style=\"color: #d81b60; font-weight: bold; font-size: 1.2em;\"\u003e🏅️ #1\u003c/span\u003e among open-source frameworks! 🏆\n  \u003c/h3\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n🦉 OWL is a cutting-edge framework for multi-agent collaboration that pushes the boundaries of task automation, built on top of the [CAMEL-AI Framework](https://github.com/camel-ai/camel).\n\n\u003c!-- OWL achieves **58.18** average score on [GAIA](https://huggingface.co/spaces/gaia-benchmark/leaderboard) benchmark and ranks 🏅️ #1 among open-source frameworks. --\u003e\n\nOur vision is to revolutionize how AI agents collaborate to solve real-world tasks. By leveraging dynamic agent interactions, OWL enables more natural, efficient, and robust task automation across diverse domains.\n\n\u003c/div\u003e\n\n![](./assets/owl_architecture.png)\n\n\u003cbr\u003e\n\n\n\u003c/div\u003e\n\n\u003c!-- # Key Features --\u003e\n# 📋 Table of Contents\n\n- [📋 Table of Contents](#-table-of-contents)\n- [🔥 News](#-news)\n- [🎬 Demo Video](#-demo-video)\n- [✨️ Core Features](#-code-features)\n- [🛠️ Installation](#️-installation)\n  - [**Clone the Github repository**](#clone-the-github-repository)\n  - [**Set up Environment**](#set-up-environment)\n  - [**Install Dependencies**](#install-dependencies)\n  - [**Setup Environment Variables**](#setup-environment-variables)\n- [🚀 Quick Start](#-quick-start)\n- [🧪 Experiments](#-experiments)\n- [⏱️ Future Plans](#️-future-plans)\n- [📄 License](#-license)\n- [🖊️ Cite](#️-cite)\n- [🔥 Community](#-community)\n- [❓ FAQ](#-faq)\n- [⭐ Star History](#-star-history)\n\n\n# 🔥 News\n\n- **[2025.03.07]**: We open-source the codebase of 🦉 OWL project.\n\n# 🎬 Demo Video\n\nhttps://private-user-images.githubusercontent.com/55657767/420211368-f29f477d-7eef-46da-8d7a-8f3bcf506da2.mp4\n\nhttps://private-user-images.githubusercontent.com/55657767/420212194-e813fc05-136a-485f-8df3-f10d9b4e63ec.mp4\n\n# ✨️ Core Features\n\n- **Real-time Information Retrieval**: Leverage Wikipedia, Google Search, and other online sources for up-to-date information.\n- **Multimodal Processing**: Support for handling internet or local videos, images, and audio data.\n- **Browser Automation**: Utilize the Playwright framework for simulating browser interactions, including scrolling, clicking, input handling, downloading, navigation, and more.\n- **Document Parsing**: Extract content from Word, Excel, PDF, and PowerPoint files, converting them into text or Markdown format.\n- **Code Execution**: Write and execute Python code using interpreter.\n\n# 🛠️ Installation\n\n## **Clone the Github repository**\n\n```bash\ngit clone https://github.com/camel-ai/owl.git\ncd owl\n```\n\n## **Set up Environment**\n\nUsing Conda (recommended):\n```bash\nconda create -n owl python=3.11\nconda activate owl\n```\n\nUsing venv (alternative):\n```bash\npython -m venv owl_env\n# On Windows\nowl_env\\Scripts\\activate\n# On Unix or MacOS\nsource owl_env/bin/activate\n```\n\n\n## **Install Dependencies**\n\n```bash\npython -m pip install -r requirements.txt\nplaywright install\n```\n\n## **Setup Environment Variables** \n\nIn the `owl/.env_template` file, you will find all the necessary API keys along with the websites where you can register for each service. To use these API services, follow these steps:\n\n1. *Copy and Rename*: Duplicate the `.env_example` file and rename the copy to `.env`.\n```bash\ncp owl/.env_template .env\n```\n2. *Fill in Your Keys*: Open the `.env` file and insert your API keys in the corresponding fields.  (For the minimal example (`run_mini.py`), you only need to configure the LLM API key (e.g., OPENAI_API_KEY).)\n3. *For using more other models*: please refer to our CAMEL models docs:https://docs.camel-ai.org/key_modules/models.html#supported-model-platforms-in-camel\n\n\n\u003e **Note**: For optimal performance, we strongly recommend using OpenAI models. Our experiments show that other models may result in significantly lower performance on complex tasks and benchmarks.\n\n# 🚀 Quick Start\n   \nRun the following demo case:\n\n```bash\npython owl/run.py\n```\n\nFor a simpler version that only requires an LLM API key, you can try our minimal example:\n\n```bash\npython owl/run_mini.py\n```\n\nYou can run OWL agent with your own task by modifying the `run.py` script:\n\n```python\n# Define your own task\nquestion = \"Task description here.\"\n\nsociety = construct_society(question)\nanswer, chat_history, token_count = run_society(society)\n\nlogger.success(f\"Answer: {answer}\")\n```\n\nExample tasks you can try:\n- \"Find the latest stock price for Apple Inc.\"\n- \"Analyze the sentiment of recent tweets about climate change\"\n- \"Help me debug this Python code: [your code here]\"\n- \"Summarize the main points from this research paper: [paper URL]\"\n\n# 🧪 Experiments\n\nWe provided a script to reproduce the results on GAIA. \nYou can check the `run_gaia_roleplaying.py` file and run the following command:\n\n```bash\npython run_gaia_roleplaying.py\n```\n\n# ⏱️ Future Plans\n\n- [ ] Write a technical blog post detailing our exploration and insights in multi-agent collaboration in real-world tasks.\n- [ ] Enhance the toolkit ecosystem with more specialized tools for domain-specific tasks.\n- [ ] Develop more sophisticated agent interaction patterns and communication protocols\n\n\n# 📄 License\n\nThe source code is licensed under Apache 2.0.\n\n# 🖊️ Cite\n\nIf you find this repo useful, please cite:\n\n\n```\n@misc{owl2025,\n  title        = {OWL: Optimized Workforce Learning for General Multi-Agent Assistance in Real-World Task Automation},\n  author       = {{CAMEL-AI.org}},\n  howpublished = {\\url{https://github.com/camel-ai/owl}},\n  note         = {Accessed: 2025-03-07},\n  year         = {2025}\n}\n```\n\n# 🔥 Community\nJoin us for further discussions!\n\u003c!-- ![](./assets/community.png) --\u003e\n![](./assets/community_5.jpg)\n\u003c!-- ![](./assets/meetup.jpg) --\u003e\n\n# ❓ FAQ\n\n**Q: Why is my Chrome browser showing a blank screen even though there's output in the console?**\n\nA: This is expected behavior. When OWL determines that a task can be completed using non-browser tools (like search, code analysis, etc.), the browser window may remain blank. The browser is only activated when web interaction is necessary. We plan to implement lazy loading in future updates to improve this user experience.\n\n# ⭐ Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=camel-ai/owl\u0026type=Date)](https://star-history.com/#camel-ai/owl\u0026Date)\n\n\n\n[docs-image]: https://img.shields.io/badge/Documentation-EB3ECC\n[docs-url]: https://camel-ai.github.io/camel/index.html\n[star-image]: https://img.shields.io/github/stars/camel-ai/owl?label=stars\u0026logo=github\u0026color=brightgreen\n[star-url]: https://github.com/camel-ai/owl/stargazers\n[package-license-image]: https://img.shields.io/badge/License-Apache_2.0-blue.svg\n[package-license-url]: https://github.com/camel-ai/owl/blob/main/licenses/LICENSE\n\n[colab-url]: https://colab.research.google.com/drive/1AzP33O8rnMW__7ocWJhVBXjKziJXPtim?usp=sharing\n[colab-image]: https://colab.research.google.com/assets/colab-badge.svg\n[huggingface-url]: https://huggingface.co/camel-ai\n[huggingface-image]: https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-CAMEL--AI-ffc107?color=ffc107\u0026logoColor=white\n[discord-url]: https://discord.camel-ai.org/\n[discord-image]: https://img.shields.io/discord/1082486657678311454?logo=discord\u0026labelColor=%20%235462eb\u0026logoColor=%20%23f5f5f5\u0026color=%20%235462eb\n[wechat-url]: https://ghli.org/camel/wechat.png\n[wechat-image]: https://img.shields.io/badge/WeChat-CamelAIOrg-brightgreen?logo=wechat\u0026logoColor=white\n[x-url]: https://x.com/CamelAIOrg\n[x-image]: https://img.shields.io/twitter/follow/CamelAIOrg?style=social\n[twitter-image]: https://img.shields.io/twitter/follow/CamelAIOrg?style=social\u0026color=brightgreen\u0026logo=twitter\n[reddit-url]: https://www.reddit.com/r/CamelAI/\n[reddit-image]: https://img.shields.io/reddit/subreddit-subscribers/CamelAI?style=plastic\u0026logo=reddit\u0026label=r%2FCAMEL\u0026labelColor=white\n[ambassador-url]: https://www.camel-ai.org/community\n[owl-url]: ./assets/qr_code.jpg\n[owl-image]: https://img.shields.io/badge/WeChat-OWLProject-brightgreen?logo=wechat\u0026logoColor=white\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagent-network-protocol%2Fowl_anp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagent-network-protocol%2Fowl_anp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagent-network-protocol%2Fowl_anp/lists"}