XiangJinYu commited on
Commit
ae33945
Β·
verified Β·
1 Parent(s): fe5c39d

restore README

Browse files
Files changed (1) hide show
  1. README.md +12 -199
README.md CHANGED
@@ -1,199 +1,12 @@
1
-
2
- # MetaGPT: The Multi-Agent Framework
3
-
4
- <p align="center">
5
- <a href=""><img 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"></a>
6
- </p>
7
-
8
- <p align="center">
9
- <b>Assign different roles to GPTs to form a collaborative entity for complex tasks.</b>
10
- </p>
11
-
12
- <p align="center">
13
- <a href="docs/README_CN.md"><img src="https://img.shields.io/badge/ζ–‡ζ‘£-δΈ­ζ–‡η‰ˆ-blue.svg" alt="CN doc"></a>
14
- <a href="README.md"><img src="https://img.shields.io/badge/document-English-blue.svg" alt="EN doc"></a>
15
- <a href="docs/README_FR.md"><img src="https://img.shields.io/badge/document-French-blue.svg" alt="FR doc"></a>
16
- <a href="docs/README_JA.md"><img src="https://img.shields.io/badge/ドキγƒ₯γƒ‘γƒ³γƒˆ-ζ—₯本θͺž-blue.svg" alt="JA doc"></a>
17
- <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
18
- <a href="docs/ROADMAP.md"><img src="https://img.shields.io/badge/ROADMAP-θ·―ηΊΏε›Ύ-blue" alt="roadmap"></a>
19
- <a href="https://discord.gg/DYn29wFk9z"><img src="https://dcbadge.vercel.app/api/server/DYn29wFk9z?style=flat" alt="Discord Follow"></a>
20
- <a href="https://twitter.com/MetaGPT_"><img src="https://img.shields.io/twitter/follow/MetaGPT?style=social" alt="Twitter Follow"></a>
21
- </p>
22
-
23
- <p align="center">
24
- <a href="https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/geekan/MetaGPT"><img src="https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode" alt="Open in Dev Containers"></a>
25
- <a href="https://codespaces.new/geekan/MetaGPT"><img src="https://img.shields.io/badge/Github_Codespace-Open-blue?logo=github" alt="Open in GitHub Codespaces"></a>
26
- <a href="https://huggingface.co/spaces/deepwisdom/MetaGPT-SoftwareCompany" target="_blank"><img alt="Hugging Face" src="https://img.shields.io/badge/%F0%9F%A4%97%20-Hugging%20Face-blue?color=blue&logoColor=white" /></a>
27
- </p>
28
-
29
- ## News
30
- πŸš€ Oct. 29, 2024: We introduced three papers: [AFLOW](https://arxiv.org/abs/2410.10762), [FACT](https://arxiv.org/abs/2410.21012), and [SELA](https://arxiv.org/abs/2410.17238), check the [code](examples)!
31
-
32
- πŸš€ Mar. 29, 2024: [v0.8.0](https://github.com/geekan/MetaGPT/releases/tag/v0.8.0) released. Now you can use Data Interpreter ([arxiv](https://arxiv.org/abs/2402.18679), [example](https://docs.deepwisdom.ai/main/en/DataInterpreter/), [code](https://github.com/geekan/MetaGPT/tree/main/examples/di)) via pypi package import. Meanwhile, we integrated the RAG module and supported multiple new LLMs.
33
-
34
- πŸš€ Feb. 08, 2024: [v0.7.0](https://github.com/geekan/MetaGPT/releases/tag/v0.7.0) released, supporting assigning different LLMs to different Roles. We also introduced [Data Interpreter](https://github.com/geekan/MetaGPT/blob/main/examples/di/README.md), a powerful agent capable of solving a wide range of real-world problems.
35
-
36
- πŸš€ Jan. 16, 2024: Our paper [MetaGPT: Meta Programming for A Multi-Agent Collaborative Framework
37
- ](https://openreview.net/forum?id=VtmBAGCN7o) accepted for **oral presentation (top 1.2%)** at ICLR 2024, **ranking #1** in the LLM-based Agent category.
38
-
39
- πŸš€ Jan. 03, 2024: [v0.6.0](https://github.com/geekan/MetaGPT/releases/tag/v0.6.0) released, new features include serialization, upgraded OpenAI package and supported multiple LLM, provided [minimal example for debate](https://github.com/geekan/MetaGPT/blob/main/examples/debate_simple.py) etc.
40
-
41
- πŸš€ Dec. 15, 2023: [v0.5.0](https://github.com/geekan/MetaGPT/releases/tag/v0.5.0) released, introducing some experimental features such as incremental development, multilingual, multiple programming languages, etc.
42
-
43
- πŸ”₯ Nov. 08, 2023: MetaGPT is selected into [Open100: Top 100 Open Source achievements](https://www.benchcouncil.org/evaluation/opencs/annual.html).
44
-
45
- πŸ”₯ Sep. 01, 2023: MetaGPT tops GitHub Trending Monthly for the **17th time** in August 2023.
46
-
47
- 🌟 Jun. 30, 2023: MetaGPT is now open source.
48
-
49
- 🌟 Apr. 24, 2023: First line of MetaGPT code committed.
50
-
51
- ## Software Company as Multi-Agent System
52
-
53
- 1. MetaGPT takes a **one line requirement** as input and outputs **user stories / competitive analysis / requirements / data structures / APIs / documents, etc.**
54
- 2. Internally, MetaGPT includes **product managers / architects / project managers / engineers.** It provides the entire process of a **software company along with carefully orchestrated SOPs.**
55
- 1. `Code = SOP(Team)` is the core philosophy. We materialize SOP and apply it to teams composed of LLMs.
56
-
57
- ![A software company consists of LLM-based roles](docs/resources/software_company_cd.jpeg)
58
-
59
- <p align="center">Software Company Multi-Agent Schematic (Gradually Implementing)</p>
60
-
61
- ## Get Started
62
-
63
- ### Installation
64
-
65
- > 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`.
66
- > You can use conda like this: `conda create -n metagpt python=3.9 && conda activate metagpt`
67
-
68
- ```bash
69
- pip install --upgrade metagpt
70
- # or `pip install --upgrade git+https://github.com/geekan/MetaGPT.git`
71
- # or `git clone https://github.com/geekan/MetaGPT && cd MetaGPT && pip install --upgrade -e .`
72
- ```
73
-
74
- For detailed installation guidance, please refer to [cli_install](https://docs.deepwisdom.ai/main/en/guide/get_started/installation.html#install-stable-version)
75
- or [docker_install](https://docs.deepwisdom.ai/main/en/guide/get_started/installation.html#install-with-docker)
76
-
77
- ### Configuration
78
-
79
- You can init the config of MetaGPT by running the following command, or manually create `~/.metagpt/config2.yaml` file:
80
- ```bash
81
- # Check https://docs.deepwisdom.ai/main/en/guide/get_started/configuration.html for more details
82
- metagpt --init-config # it will create ~/.metagpt/config2.yaml, just modify it to your needs
83
- ```
84
-
85
- You 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):
86
-
87
- ```yaml
88
- llm:
89
- api_type: "openai" # or azure / ollama / groq etc. Check LLMType for more options
90
- model: "gpt-4-turbo" # or gpt-3.5-turbo
91
- base_url: "https://api.openai.com/v1" # or forward url / other llm url
92
- api_key: "YOUR_API_KEY"
93
- ```
94
-
95
- ### Usage
96
-
97
- After installation, you can use MetaGPT at CLI
98
-
99
- ```bash
100
- metagpt "Create a 2048 game" # this will create a repo in ./workspace
101
- ```
102
-
103
- or use it as library
104
-
105
- ```python
106
- from metagpt.software_company import generate_repo, ProjectRepo
107
- repo: ProjectRepo = generate_repo("Create a 2048 game") # or ProjectRepo("<path>")
108
- print(repo) # it will print the repo structure with files
109
- ```
110
-
111
- You can also use [Data Interpreter](https://github.com/geekan/MetaGPT/tree/main/examples/di) to write code:
112
-
113
- ```python
114
- import asyncio
115
- from metagpt.roles.di.data_interpreter import DataInterpreter
116
-
117
- async def main():
118
- di = DataInterpreter()
119
- await di.run("Run data analysis on sklearn Iris dataset, include a plot")
120
-
121
- asyncio.run(main()) # or await main() in a jupyter notebook setting
122
- ```
123
-
124
-
125
- ### QuickStart & Demo Video
126
- - Try it on [MetaGPT Huggingface Space](https://huggingface.co/spaces/deepwisdom/MetaGPT-SoftwareCompany)
127
- - [Matthew Berman: How To Install MetaGPT - Build A Startup With One Prompt!!](https://youtu.be/uT75J_KG_aY)
128
- - [Official Demo Video](https://github.com/geekan/MetaGPT/assets/2707039/5e8c1062-8c35-440f-bb20-2b0320f8d27d)
129
-
130
- https://github.com/geekan/MetaGPT/assets/34952977/34345016-5d13-489d-b9f9-b82ace413419
131
-
132
- ## Tutorial
133
-
134
- - πŸ—’ [Online Document](https://docs.deepwisdom.ai/main/en/)
135
- - πŸ’» [Usage](https://docs.deepwisdom.ai/main/en/guide/get_started/quickstart.html)
136
- - πŸ”Ž [What can MetaGPT do?](https://docs.deepwisdom.ai/main/en/guide/get_started/introduction.html)
137
- - πŸ›  How to build your own agents?
138
- - [MetaGPT Usage & Development Guide | Agent 101](https://docs.deepwisdom.ai/main/en/guide/tutorials/agent_101.html)
139
- - [MetaGPT Usage & Development Guide | MultiAgent 101](https://docs.deepwisdom.ai/main/en/guide/tutorials/multi_agent_101.html)
140
- - πŸ§‘β€πŸ’» Contribution
141
- - [Develop Roadmap](docs/ROADMAP.md)
142
- - πŸ”– Use Cases
143
- - [Data Interpreter](https://docs.deepwisdom.ai/main/en/guide/use_cases/agent/interpreter/intro.html)
144
- - [Debate](https://docs.deepwisdom.ai/main/en/guide/use_cases/multi_agent/debate.html)
145
- - [Researcher](https://docs.deepwisdom.ai/main/en/guide/use_cases/agent/researcher.html)
146
- - [Receipt Assistant](https://docs.deepwisdom.ai/main/en/guide/use_cases/agent/receipt_assistant.html)
147
- - ❓ [FAQs](https://docs.deepwisdom.ai/main/en/guide/faq.html)
148
-
149
- ## Support
150
-
151
- ### Discord Join US
152
-
153
- πŸ“’ Join Our [Discord Channel](https://discord.gg/ZRHeExS6xv)! Looking forward to seeing you there! πŸŽ‰
154
-
155
- ### Contributor form
156
-
157
- πŸ“ [Fill out the form](https://airtable.com/appInfdG0eJ9J4NNL/pagK3Fh1sGclBvVkV/form) to become a contributor. We are looking forward to your participation!
158
-
159
- ### Contact Information
160
-
161
- If you have any questions or feedback about this project, please feel free to contact us. We highly appreciate your suggestions!
162
-
163
- - **Email:** [email protected]
164
- - **GitHub Issues:** For more technical inquiries, you can also create a new issue in our [GitHub repository](https://github.com/geekan/metagpt/issues).
165
-
166
- We will respond to all questions within 2-3 business days.
167
-
168
- ## Citation
169
-
170
- To stay updated with the latest research and development, follow [@MetaGPT_](https://twitter.com/MetaGPT_) on Twitter.
171
-
172
- To cite [MetaGPT](https://openreview.net/forum?id=VtmBAGCN7o) or [Data Interpreter](https://arxiv.org/abs/2402.18679) in publications, please use the following BibTeX entries.
173
-
174
- ```bibtex
175
- @inproceedings{hong2024metagpt,
176
- title={Meta{GPT}: Meta Programming for A Multi-Agent Collaborative Framework},
177
- 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},
178
- booktitle={The Twelfth International Conference on Learning Representations},
179
- year={2024},
180
- url={https://openreview.net/forum?id=VtmBAGCN7o}
181
- }
182
- @misc{hong2024data,
183
- title={Data Interpreter: An LLM Agent For Data Science},
184
- author={Sirui Hong and Yizhang Lin and Bang Liu and Bangbang Liu and Binhao Wu and Danyang Li and Jiaqi Chen and Jiayi Zhang and Jinlin Wang and Li Zhang and Lingyao Zhang and Min Yang and Mingchen Zhuge and Taicheng Guo and Tuo Zhou and Wei Tao and Wenyi Wang and Xiangru Tang and Xiangtao Lu and Xiawu Zheng and Xinbing Liang and Yaying Fei and Yuheng Cheng and Zongze Xu and Chenglin Wu},
185
- year={2024},
186
- eprint={2402.18679},
187
- archivePrefix={arXiv},
188
- primaryClass={cs.AI}
189
- }
190
- @misc{zhang2024aflow,
191
- title={AFlow: Automating Agentic Workflow Generation},
192
- author={Jiayi Zhang and Jinyu Xiang and Zhaoyang Yu and Fengwei Teng and Xionghui Chen and Jiaqi Chen and Mingchen Zhuge and Xin Cheng and Sirui Hong and Jinlin Wang and Bingnan Zheng and Bang Liu and Yuyu Luo and Chenglin Wu},
193
- year={2024},
194
- eprint={2410.10762},
195
- archivePrefix={arXiv},
196
- primaryClass={cs.AI},
197
- url={https://arxiv.org/abs/2410.10762},
198
- }
199
- ```
 
1
+ ---
2
+ title: SPO
3
+ emoji: πŸŒ–
4
+ colorFrom: pink
5
+ colorTo: pink
6
+ sdk: streamlit
7
+ sdk_version: 1.42.0
8
+ app_file: app.py
9
+ pinned: false
10
+ license: apache-2.0
11
+ short_description: Self-Supervised Prompt Optimization
12
+ ---