FoundationAgents /MetaGPT
🌟 The Multi-Agent Framework: First AI Software Company, Towards Natural Language Programming
★ 71,235⑂ 9,107👁 912⑃ 1,117● 991▤ 22◈ 0
71,235
stars
+10
9,107
forks
912
watchers
1,117
prs
991
issues
22
releases
0
discussions
README
MetaGPT: The Multi-Agent Framework
[ En |
中 |
Fr |
日 ]
Assign different roles to GPTs to form a collaborative entity for complex tasks.
News
🚀 Mar. 10, 2025: 🎉 mgx.dev is the 1 Product of the Week on @ProductHunt! 🏆
🚀 Mar. 4, 2025: 🎉 mgx.dev is the 1 Product of the Day on @ProductHunt! 🏆
🚀 Feb. 19, 2025: Today we are officially launching our natural language programming product: MGX (MetaGPT X) - the world's first AI agent development team. More details on Twitter.
🚀 Feb. 17, 2025: We introduced two papers: SPO and AOT, check the code!
🚀 Jan. 22, 2025: Our paper AFlow: Automating Agentic Workflow Generation accepted for oral presentation (top 1.8%) at ICLR 2025, ranking 2 in the LLM-based Agent category.
👉👉 Earlier news
Software Company as Multi-Agent System
1. MetaGPT takes a one line requirement as input and outputs user stories / competitive analysis / requirements / data structures / APIs / documents, etc.
2. Internally, MetaGPT includes product managers / architects / project managers / engineers. It provides the entire process of a software company along with carefully orchestrated SOPs.
1. Code = SOP(Team) is the core philosophy. We materialize SOP and apply it to teams composed of LLMs.
!A software company consists of LLM-based roles
Software Company Multi-Agent Schematic (Gradually Implementing)
Get Started
Installation
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.
You can use conda like this: conda create -n metagpt python=3.9 && conda activate metagpt
bash
pip install --upgrade metagpt
or pip install --upgrade git+https://github.com/geekan/MetaGPT.git
or git clone https://github.com/geekan/MetaGPT && cd MetaGPT && pip install --upgrade -e .
Install node and pnpm before actual use.
For detailed installation guidance, please refer to cli_install
or docker_install
Configuration
You can init the config of MetaGPT by running the following command, or manually create ~/.metagpt/config2.yaml file:
bash
Check https://docs.deepwisdom.ai/main/en/guide/get_started/configuration.html for more details
metagpt --init-config it will create ~/.metagpt/config2.yaml, just modify it to your needs
You can configure ~/.metagpt/config2.yaml according to the example and doc:
yaml
llm:
api_type: "openai" or azure / ollama / groq etc. Check LLMType for more options
model: "gpt-4-turbo" or gpt-3.5-turbo
base_url: "https://api.openai.com/v1" or forward url / other llm url
api_key: "YOUR_API_KEY"
Usage
After installation, you can use MetaGPT at CLI
bash
metagpt "Create a 2048 game" this will create a repo in ./workspace
or use it as library
python
from metagpt.software_company import generate_repo
from metagpt.utils.project_repo import ProjectRepo
repo: ProjectRepo = generate_repo("Create a 2048 game") or ProjectRepo("")
print(repo) it will print the repo structure with files
You caTop issues
#2110Terminal.run_command() hangs indefinitely on Linux/WSL2 — end-of-command marker never yielded from splitlines/tuple-unpack6 comments · 2026-07-20#2181CustomDecoder rejects escaped apostrophes in single-quoted strings1 comments · 2026-10-31#2166DependencyFile.load corrupts Unicode paths and escaped quotes during save/load round trips1 comments · 2026-09-29#2165repair_json_format truncates valid JSON strings containing escaped quotes and URLs1 comments · 2026-09-28#2163OpenAILLM ignores usage-only streaming chunks with empty choices1 comments · 2026-09-28#2151Pending role messages can be lost across Team serialize/deserialize recovery1 comments · 2026-09-11#2191WebPage.get_links drops protocol-relative links without a path0 comments · 2026-11-05#2187fix(utils): allow single-quoted keys in CustomDecoder JSONObject for multi-key objects and whitespace0 comments · 2026-11-03
Latest release
Patch release: v0.8.1 v0.8.1 2024-04-22fix bug