{"id":27895313,"url":"https://github.com/foundationagents/metagpt","last_synced_at":"2026-01-15T22:18:05.649Z","repository":{"id":177566813,"uuid":"660551251","full_name":"FoundationAgents/MetaGPT","owner":"FoundationAgents","description":"🌟 The Multi-Agent Framework: First AI Software Company, Towards Natural Language Programming","archived":false,"fork":false,"pushed_at":"2025-03-31T07:17:13.000Z","size":184089,"stargazers_count":55290,"open_issues_count":110,"forks_count":6581,"subscribers_count":835,"default_branch":"main","last_synced_at":"2025-05-05T15:14:34.670Z","etag":null,"topics":["agent","gpt","llm","metagpt","multi-agent"],"latest_commit_sha":null,"homepage":"https://mgx.dev/","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/FoundationAgents.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":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-06-30T09:04:55.000Z","updated_at":"2025-05-05T15:07:08.000Z","dependencies_parsed_at":"2023-09-26T06:50:41.523Z","dependency_job_id":"5d6de9fc-a2ba-4e87-90a3-b6343951ef6a","html_url":"https://github.com/FoundationAgents/MetaGPT","commit_stats":null,"previous_names":["geekan/metagpt","foundationagents/metagpt"],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FoundationAgents%2FMetaGPT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FoundationAgents%2FMetaGPT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FoundationAgents%2FMetaGPT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FoundationAgents%2FMetaGPT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FoundationAgents","download_url":"https://codeload.github.com/FoundationAgents/MetaGPT/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253819585,"owners_count":21969387,"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","gpt","llm","metagpt","multi-agent"],"created_at":"2025-05-05T15:14:25.133Z","updated_at":"2026-01-15T22:18:05.642Z","avatar_url":"https://github.com/FoundationAgents.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# MetaGPT: The Multi-Agent Framework\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"\"\u003e\u003cimg src=\"docs/resources/MetaGPT-new-log.png\" alt=\"MetaGPT logo: Enable GPT to work in a software company, collaborating to tackle more complex tasks.\" width=\"150px\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n[ \u003cb\u003eEn\u003c/b\u003e |\n\u003ca href=\"docs/README_CN.md\"\u003e中\u003c/a\u003e |\n\u003ca href=\"docs/README_FR.md\"\u003eFr\u003c/a\u003e |\n\u003ca href=\"docs/README_JA.md\"\u003e日\u003c/a\u003e ]\n\u003cb\u003eAssign different roles to 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://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-blue.svg\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n\u003ca href=\"https://discord.gg/DYn29wFk9z\"\u003e\u003cimg src=\"https://img.shields.io/badge/Join-Discord-gGnrXvVz7a?logo=discord\" alt=\"Discord Follow\"\u003e\u003c/a\u003e\n\u003ca href=\"https://twitter.com/MetaGPT_\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/MetaGPT?style=social\" alt=\"Twitter Follow\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch4 align=\"center\"\u003e\n    \n\u003c/h4\u003e\n\n## News\n\n🚀 Mar. 10, 2025: 🎉 [mgx.dev](https://mgx.dev/) is the #1 Product of the Week on @ProductHunt! 🏆\n\n🚀 Mar. \u0026nbsp; 4, 2025: 🎉 [mgx.dev](https://mgx.dev/) is the #1 Product of the Day on @ProductHunt! 🏆\n\n🚀 Feb. 19, 2025: Today we are officially launching our natural language programming product: [MGX (MetaGPT X)](https://mgx.dev/) - the world's first AI agent development team. More details on [Twitter](https://x.com/MetaGPT_/status/1892199535130329356).\n\n🚀 Feb. 17, 2025: We introduced two papers: [SPO](https://arxiv.org/pdf/2502.06855) and [AOT](https://arxiv.org/pdf/2502.12018), check the [code](examples)!\n\n🚀 Jan. 22, 2025: Our paper [AFlow: Automating Agentic Workflow Generation](https://openreview.net/forum?id=z5uVAKwmjf) accepted for **oral presentation (top 1.8%)** at ICLR 2025, **ranking #2** in the LLM-based Agent category.\n\n👉👉 [Earlier news](docs/NEWS.md) \n\n## Software Company as Multi-Agent System\n\n1. MetaGPT takes a **one line requirement** as input and outputs **user stories / competitive analysis / requirements / data structures / APIs / documents, etc.**\n2. Internally, MetaGPT includes **product managers / architects / project managers / engineers.** It provides the entire process of a **software company along with carefully orchestrated SOPs.**\n   1. `Code = SOP(Team)` is the core philosophy. We materialize SOP and apply it to teams composed of LLMs.\n\n![A software company consists of LLM-based roles](docs/resources/software_company_cd.jpeg)\n\n\u003cp align=\"center\"\u003eSoftware Company Multi-Agent Schematic (Gradually Implementing)\u003c/p\u003e\n\n## Get Started\n\n### Installation\n\n\u003e Ensure that Python 3.9 or later, but less than 3.12, is installed on your system. You can check this by using: `python --version`.  \n\u003e You can use conda like this: `conda create -n metagpt python=3.9 \u0026\u0026 conda activate metagpt`\n\n```bash\npip install --upgrade metagpt\n# or `pip install --upgrade git+https://github.com/geekan/MetaGPT.git`\n# or `git clone https://github.com/geekan/MetaGPT \u0026\u0026 cd MetaGPT \u0026\u0026 pip install --upgrade -e .`\n```\n\n**Install [node](https://nodejs.org/en/download) and [pnpm](https://pnpm.io/installation#using-npm) before actual use.**\n\nFor detailed installation guidance, please refer to [cli_install](https://docs.deepwisdom.ai/main/en/guide/get_started/installation.html#install-stable-version)\n or [docker_install](https://docs.deepwisdom.ai/main/en/guide/get_started/installation.html#install-with-docker)\n\n### Configuration\n\nYou can init the config of MetaGPT by running the following command, or manually create `~/.metagpt/config2.yaml` file:\n```bash\n# Check https://docs.deepwisdom.ai/main/en/guide/get_started/configuration.html for more details\nmetagpt --init-config  # it will create ~/.metagpt/config2.yaml, just modify it to your needs\n```\n\nYou can configure `~/.metagpt/config2.yaml` according to the [example](https://github.com/geekan/MetaGPT/blob/main/config/config2.example.yaml) and [doc](https://docs.deepwisdom.ai/main/en/guide/get_started/configuration.html):\n\n```yaml\nllm:\n  api_type: \"openai\"  # or azure / ollama / groq etc. Check LLMType for more options\n  model: \"gpt-4-turbo\"  # or gpt-3.5-turbo\n  base_url: \"https://api.openai.com/v1\"  # or forward url / other llm url\n  api_key: \"YOUR_API_KEY\"\n```\n\n### Usage\n\nAfter installation, you can use MetaGPT at CLI\n\n```bash\nmetagpt \"Create a 2048 game\"  # this will create a repo in ./workspace\n```\n\nor use it as library\n\n```python\nfrom metagpt.software_company import generate_repo\nfrom metagpt.utils.project_repo import ProjectRepo\n\nrepo: ProjectRepo = generate_repo(\"Create a 2048 game\")  # or ProjectRepo(\"\u003cpath\u003e\")\nprint(repo)  # it will print the repo structure with files\n```\n\nYou can also use [Data Interpreter](https://github.com/geekan/MetaGPT/tree/main/examples/di) to write code:\n\n```python\nimport asyncio\nfrom metagpt.roles.di.data_interpreter import DataInterpreter\n\nasync def main():\n    di = DataInterpreter()\n    await di.run(\"Run data analysis on sklearn Iris dataset, include a plot\")\n\nasyncio.run(main())  # or await main() in a jupyter notebook setting\n```\n\n\n### QuickStart \u0026 Demo Video\n- Try it on [MetaGPT Huggingface Space](https://huggingface.co/spaces/deepwisdom/MetaGPT-SoftwareCompany)\n- [Matthew Berman: How To Install MetaGPT - Build A Startup With One Prompt!!](https://youtu.be/uT75J_KG_aY)\n- [Official Demo Video](https://github.com/geekan/MetaGPT/assets/2707039/5e8c1062-8c35-440f-bb20-2b0320f8d27d)\n\nhttps://github.com/user-attachments/assets/888cb169-78c3-4a42-9d62-9d90ed3928c9\n\n## Tutorial\n\n- 🗒 [Online Document](https://docs.deepwisdom.ai/main/en/)\n- 💻 [Usage](https://docs.deepwisdom.ai/main/en/guide/get_started/quickstart.html)  \n- 🔎 [What can MetaGPT do?](https://docs.deepwisdom.ai/main/en/guide/get_started/introduction.html)\n- 🛠 How to build your own agents? \n  - [MetaGPT Usage \u0026 Development Guide | Agent 101](https://docs.deepwisdom.ai/main/en/guide/tutorials/agent_101.html)\n  - [MetaGPT Usage \u0026 Development Guide | MultiAgent 101](https://docs.deepwisdom.ai/main/en/guide/tutorials/multi_agent_101.html)\n- 🧑‍💻 Contribution\n  - [Develop Roadmap](docs/ROADMAP.md)\n- 🔖 Use Cases\n  - [Data Interpreter](https://docs.deepwisdom.ai/main/en/guide/use_cases/agent/interpreter/intro.html)\n  - [Debate](https://docs.deepwisdom.ai/main/en/guide/use_cases/multi_agent/debate.html)\n  - [Researcher](https://docs.deepwisdom.ai/main/en/guide/use_cases/agent/researcher.html)\n  - [Receipt Assistant](https://docs.deepwisdom.ai/main/en/guide/use_cases/agent/receipt_assistant.html)\n- ❓ [FAQs](https://docs.deepwisdom.ai/main/en/guide/faq.html)\n\n## Support\n\n### Discord Join US\n\n📢 Join Our [Discord Channel](https://discord.gg/ZRHeExS6xv)! Looking forward to seeing you there! 🎉\n\n### Contributor form\n\n📝 [Fill out the form](https://airtable.com/appInfdG0eJ9J4NNL/pagK3Fh1sGclBvVkV/form) to become a contributor. We are looking forward to your participation!\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:** alexanderwu@deepwisdom.ai\n- **GitHub Issues:** For more technical inquiries, you can also create a new issue in our [GitHub repository](https://github.com/geekan/metagpt/issues).\n\nWe will respond to all questions within 2-3 business days.\n\n## Citation\n\nTo stay updated with the latest research and development, follow [@MetaGPT_](https://twitter.com/MetaGPT_) on Twitter. \n\nTo cite [MetaGPT](https://openreview.net/forum?id=VtmBAGCN7o) in publications, please use the following BibTeX entries.   \n\n```bibtex\n@inproceedings{hong2024metagpt,\n      title={Meta{GPT}: Meta Programming for A Multi-Agent Collaborative Framework},\n      author={Sirui Hong and Mingchen Zhuge and Jonathan Chen and Xiawu Zheng and Yuheng Cheng and Jinlin Wang and Ceyao Zhang and Zili Wang and Steven Ka Shing Yau and Zijuan Lin and Liyang Zhou and Chenyu Ran and Lingfeng Xiao and Chenglin Wu and J{\\\"u}rgen Schmidhuber},\n      booktitle={The Twelfth International Conference on Learning Representations},\n      year={2024},\n      url={https://openreview.net/forum?id=VtmBAGCN7o}\n}\n```\n\nFor more work, please refer to [Academic Work](docs/ACADEMIC_WORK.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoundationagents%2Fmetagpt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffoundationagents%2Fmetagpt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoundationagents%2Fmetagpt/lists"}