{"id":13568632,"url":"https://github.com/Link-AGI/AutoAgents","last_synced_at":"2025-04-04T04:31:39.989Z","repository":{"id":189883925,"uuid":"681168020","full_name":"Link-AGI/AutoAgents","owner":"Link-AGI","description":"[IJCAI 2024] Generate different roles for GPTs to form a collaborative entity for complex tasks.","archived":false,"fork":false,"pushed_at":"2024-04-16T22:40:26.000Z","size":92324,"stargazers_count":1188,"open_issues_count":24,"forks_count":145,"subscribers_count":24,"default_branch":"main","last_synced_at":"2024-10-29T18:05:53.520Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://huggingface.co/spaces/LinkSoul/AutoAgents","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Link-AGI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-21T12:19:36.000Z","updated_at":"2024-10-29T12:12:31.000Z","dependencies_parsed_at":"2023-10-11T09:10:44.309Z","dependency_job_id":"498fbd4e-7218-4c85-9f94-0e4d541a60c6","html_url":"https://github.com/Link-AGI/AutoAgents","commit_stats":null,"previous_names":["linksoul-ai/autoagents","link-agi/autoagents"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Link-AGI%2FAutoAgents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Link-AGI%2FAutoAgents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Link-AGI%2FAutoAgents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Link-AGI%2FAutoAgents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Link-AGI","download_url":"https://codeload.github.com/Link-AGI/AutoAgents/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246436340,"owners_count":20776995,"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":[],"created_at":"2024-08-01T14:00:29.489Z","updated_at":"2025-04-04T04:31:34.981Z","avatar_url":"https://github.com/Link-AGI.png","language":"Python","funding_links":[],"categories":["CodeBase","Python","\u003cspan id=\"game\"\u003eGame (World Model \u0026 Agent)\u003c/span\u003e","A01_文本生成_文本对话","Multi-Agent \u0026 Orchestration"],"sub_categories":["\u003cspan id=\"tool\"\u003eLLM (LLM \u0026 Tool)\u003c/span\u003e","大语言对话模型及数据","Other IDEs"],"readme":"# AutoAgents: A Framework for Automatic Agent Generation\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://arxiv.org/abs/2309.17288\"\u003e\u003cimg src=\"docs/resources/logo-autoagents.jpg\" alt=\"autoagents logo: A Framework for Automatic Agent Generation.\" width=\"150px\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cb\u003eGenerate different roles for GPTs to form a collaborative entity for complex tasks.\u003c/b\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://arxiv.org/abs/2309.17288\"\u003e\u003cimg src=\"https://img.shields.io/badge/cs.CV-2309.17288-b31b1b?logo=arxiv\u0026logoColor=red\" alt=\"Paper\"\u003e\u003c/a\u003e\n\u003ca href=\"docs/README_CN.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/文档-中文版-blue.svg\" alt=\"CN doc\"\u003e\u003c/a\u003e\n\u003ca href=\"README.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/document-English-blue.svg\" alt=\"EN doc\"\u003e\u003c/a\u003e\n\u003ca href=\"docs/README_JA.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/ドキュメント-日本語-blue.svg\" alt=\"JA doc\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nAutoAgents is an experimental open-source application for an Automatic Agents Generation Experiment based on LLM. This program, driven by LLM, autonomously generates multi-agents to achieve whatever goal you set.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=./docs/resources/framework2.jpg width=\"800\"\u003e\n\u003c/p\u003e\n\n## \u003ca name=\"updates\"/\u003e :boom: Updates\n- **2024.04.16**: We're super excited to announce that our paper got accepted at IJCAI 2024. More updates will be coming soon!\n- **2023.09.31**: 📝 We're excited to share our paper [AutoAgents: A Framework for Automatic Agent Generation](https://arxiv.org/abs/2309.17288) related to this repository.\n\u003cp align=\"center\"\u003e\n\u003cimg width=\"616\" alt=\"The execution process of AutoAgents.\" src=\"docs/resources/process.jpg\"\u003e\n\u003c/p\u003e \n\n- **2023.08.30**: 🚀 Adding a custom agent collection, AgentBank, allows you to add custom agents. \n\n## 🚀 Features\n- **Planner**: Determines the expert roles to be added and the specific execution plan according to the problem.\n- **Tools**: The set of tools that can be used, currently only compatible with the search tools.\n- **Observers**: Responsible for reflecting on whether the planner and the results in the execution process are reasonable, currently including reflection checks on Agents, Plan, and Action.\n- **Agents**: Expert role agents generated by the planner, including name, expertise, tools used, and LLM enhancement.\n- **Plan**: The execution plan is composed of the generated expert roles, each step of the execution plan has at least one expert role agent.\n- **Actions**: The specific actions of the expert roles in the execution plan, such as calling tools or outputting results.\n\n## Demo\nOnline demo: \n- [Demo / HuggingFace Spaces](https://huggingface.co/spaces/LinkSoul/AutoAgents)\n\nVideo demo:\n- **Rumor Verification**\n\u003cvideo src='https://github.com/shiyemin/AutoAgents/assets/1501158/41898e0d-4137-450c-ad9b-bfb9b8c1d27b.mp4'\u003e\u003c/video\u003e\n- **Gluttonous Snake**\n\u003cvideo src='https://github.com/shiyemin/AutoAgents/assets/1501158/97e408cb-b70d-4045-82ea-07319c085138.mp4'\u003e\u003c/video\u003e\n\n## Installation and Usage\n\n### Installation\n\n```bash\ngit clone https://github.com/LinkSoul-AI/AutoAgents\ncd AutoAgents\npython setup.py install\n```\n\n### Configuration\n\n- Configure your `OPENAI_API_KEY` in any of `config/key.yaml / config/config.yaml / env`\n- Priority order: `config/key.yaml \u003e config/config.yaml \u003e env`\n\n```bash\n# Copy the configuration file and make the necessary modifications.\ncp config/config.yaml config/key.yaml\n```\n\n| Variable Name                              | config/key.yaml                           | env                                             |\n| ------------------------------------------ | ----------------------------------------- | ----------------------------------------------- |\n| OPENAI_API_KEY # Replace with your own key | OPENAI_API_KEY: \"sk-...\"                  | export OPENAI_API_KEY=\"sk-...\"                  |\n| OPENAI_API_BASE # Optional                 | OPENAI_API_BASE: \"https://\u003cYOUR_SITE\u003e/v1\" | export OPENAI_API_BASE=\"https://\u003cYOUR_SITE\u003e/v1\" |\n\n### Usage\n- Commandline mode:\n```python\npython main.py --mode commandline --llm_api_key YOUR_OPENAI_API_KEY --serpapi_key YOUR_SERPAPI_KEY --idea \"Is LK-99 really a room temperature superconducting material?\"\n```\n- Websocket service mode:\n```python\npython main.py --mode service --host \"127.0.0.1\" --port 9000\n```\n\n### Docker\n- Build docker image:\n```bash\nIMAGE=\"linksoul.ai/autoagents\"\nVERSION=1.0\n\ndocker build -f docker/Dockerfile -t \"${IMAGE}:${VERSION}\" .\n```\n- Start docker container:\n```bash\ndocker run -it --rm -p 7860:7860 \"${IMAGE}:${VERSION}\"\n```\n- Open http://127.0.0.1:7860 in the browser.\n\n## Contributing\nAutoAgents is dedicated to creating a cutting-edge automated multi-agent environment for large language models. We are actively seeking enthusiastic collaborators to embark with us on this thrilling and innovative journey.\n\nThis project exists thanks to all the people who contribute:\n\n\u003ca href=\"https://github.com/iCGY96\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/28098248?v=4\" alt=\"Contributor\" style=\"width:5%; border-radius: 50%;\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/shiyemin\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/1501158?v=4\" alt=\"Contributor\" style=\"width:5%; border-radius: 50%;\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/s1w3\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/140045858?v=4\" alt=\"Contributor\" style=\"width:5%; border-radius: 50%;\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/TabbbSY\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/140036442?v=4\" alt=\"Contributor\" style=\"width:5%; border-radius: 50%;\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/eltociear\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/22633385?v=4\" alt=\"Contributor\" style=\"width:5%; border-radius: 50%;\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/ishaan-jaff\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/29436595?v=4\" alt=\"Contributor\" style=\"width:5%; border-radius: 50%;\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Jaykef\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/11355002?v=4\" alt=\"Contributor\" style=\"width:5%; border-radius: 50%;\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/PentesterPriyanshu\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/98478305?v=4\" alt=\"Contributor\" style=\"width:5%; border-radius: 50%;\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/harshhere905\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/124420199?v=4\" alt=\"Contributor\" style=\"width:5%; border-radius: 50%;\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/hrushik98\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/91076764?v=4\" alt=\"Contributor\" style=\"width:5%; border-radius: 50%;\"/\u003e\u003c/a\u003e\n\n\n## How Can You Contribute?\n- **Issue Reporting and Pull Requests**: Encountering difficulties with AutoAgents? Feel free to raise the issue in English. Additionally, you're welcome to take initiative by resolving these issues yourself. Simply request to be assigned the issue, and upon resolution, submit a pull request (PR) with your solution.\n  \n- **Software Development Contributions**: As an engineer, your skills can significantly enhance AutoAgents. We are in constant pursuit of skilled developers to refine, optimize, and expand our framework, enriching our feature set and devising new modules.\n\n- **Content Creation for Documentation and Tutorials**: If writing is your forte, join us in improving our documentation and developing tutorials or blog posts. Your contribution will make AutoAgents more user-friendly and accessible to a diverse audience.\n\n- **Innovative Application Exploration**: Intrigued by the prospects of multi-agent systems? If you're keen to experiment with AutoAgents, we're excited to support your endeavors and curious to see your innovative creations.\n\n- **User Feedback and Strategic Suggestions**: We highly value user input. Engage with AutoAgents and share your feedback. Your insights are crucial for ongoing enhancements, ensuring our framework's excellence and relevance.\n\n## Contact Information\n\nIf you have any questions or feedback about this project, please feel free to contact us. We highly appreciate your suggestions!\n\n- **Email:** gy.chen@foxmail.com, ymshi@linksoul.ai\n- **GitHub Issues:** For more technical inquiries, you can also create a new issue in our [GitHub repository](https://github.com/LinkSoul-AI/AutoAgents/issues).\n\nWe will respond to all questions within 2-3 business days.\n\n## License\n\n[MIT license](https://raw.githubusercontent.com/LinkSoul-AI/AutoAgents/main/LICENSE)\n\n## Citation\n\nIf you find our work and this repository useful, please consider giving a star :star: and citation :beer::\n```bibtex\n@article{chen2023auto,\n  title={AutoAgents: The Automatic Agents Generation Framework},\n  author={Chen, Guangyao and Dong, Siwei and Shu, Yu and Zhang, Ge and Jaward, Sesay and Börje, Karlsson and Fu, Jie and Shi, Yemin},\n  journal={arXiv preprint},\n  year={2023}\n}\n```\n\n## Wechat Group\n\n\u003cimg src=\".github/QRcode.jpg\" alt=\"Wechat Group\" width=\"200\"/\u003e\n\n## Acknowledgements\nThe [system](https://github.com/LinkSoul-AI/AutoAgents/tree/main/autoagents/system), [action_bank](https://github.com/LinkSoul-AI/AutoAgents/tree/main/autoagents/actions/action_bank) and [role_bank](https://github.com/LinkSoul-AI/AutoAgents/tree/main/autoagents/roles/role_bank) of this code base is built using [MetaGPT](https://github.com/geekan/MetaGPT)\n\nIcons in the framework made by Darius Dan, Freepik, kmg design, Flat Icons, Vectorslab from [FlatIcon](https://www.flaticon.com)\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://star-history.com/#Link-AGI/AutoAgents\u0026Date\"\u003e\n    \u003cimg src=\"https://api.star-history.com/svg?repos=Link-AGI/AutoAgents\u0026type=Date\" alt=\"Star History Chart\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLink-AGI%2FAutoAgents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLink-AGI%2FAutoAgents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLink-AGI%2FAutoAgents/lists"}