mirror of
https://github.com/OpenBMB/ChatDev.git
synced 2024-11-07 18:40:13 +03:00
188 lines
11 KiB
Markdown
188 lines
11 KiB
Markdown
# Communicative Agents for Software Development
|
|
|
|
<p align="center">
|
|
<img src='./misc/logo1.png' width=550>
|
|
</p>
|
|
|
|
<p align="center">
|
|
【English | <a href="readme/README-Chinese.md">Chinese</a> | <a href="readme/README-Japanese.md">Japanese</a> | <a href="readme/README-Korean.md">Korean</a> | <a href="readme/README-Filipino.md">Filipino</a> | <a href="readme/README-French.md">French</a> | <a href="readme/README-Slovak.md">Slovak</a> | <a href="readme/README-Portuguese.md">Portuguese</a> | <a href="readme/README-Spanish.md">Spanish</a> | <a href="readme/README-Dutch.md">Dutch</a> | <a href="readme/README-Hindi.md">Hindi</a>】
|
|
</p>
|
|
<p align="center">
|
|
【📚 <a href="wiki.md">Wiki</a> | 🚀 <a href="wiki.md#local-demo">Local Demo</a> | 👥 <a href="Contribution.md">Community Built Software</a> | 🔧 <a href="wiki.md#customization">Customization</a>】
|
|
</p>
|
|
|
|
## 📖 Overview
|
|
|
|
- **ChatDev** stands as a **virtual software company** that operates through various **intelligent agents** holding
|
|
different roles, including Chief Executive Officer <img src='online_log/static/figures/ceo.png' height=20>, Chief Product Officer <img src='online_log/static/figures/cpo.png' height=20>, Chief Technology Officer <img src='online_log/static/figures/cto.png' height=20>, programmer <img src='online_log/static/figures/programmer.png' height=20>, reviewer <img src='online_log/static/figures/reviewer.png' height=20>, tester <img src='online_log/static/figures/tester.png' height=20>, art designer <img src='online_log/static/figures/designer.png' height=20>. These
|
|
agents form a multi-agent organizational structure and are united by a mission to "revolutionize the digital world
|
|
through programming." The agents within ChatDev **collaborate** by participating in specialized functional seminars,
|
|
including tasks such as designing, coding, testing, and documenting.
|
|
- The primary objective of ChatDev is to offer an **easy-to-use**, **highly customizable** and **extendable** framework,
|
|
which is based on large language models (LLMs) and serves as an ideal scenario for studying collective intelligence.
|
|
<p align="center">
|
|
<img src='./misc/company.png' width=600>
|
|
</p>
|
|
|
|
## 🎉 News
|
|
|
|
* **September 25th, 2023: The **Git** feature is now available**, enabling the programmer <img src='online_log/static/figures/programmer.png' height=20> to utilize GitHub for version control. To enable this feature, simply set ``"git_management"`` to ``"True"`` in ``ChatChainConfig.json``. See [guide](wiki.md#git-mode) and [example](WareHouse/Gomoku_GitMode_20231025184031).
|
|
<p align="center">
|
|
<img src='./misc/github.png' width=600>
|
|
</p>
|
|
* September 20th, 2023: The **Human-Agent-Interaction** mode is now available! You can get involved with the ChatDev team by playing the role of reviewer <img src='online_log/static/figures/reviewer.png' height=20> and making suggestions to the programmer <img src='online_log/static/figures/programmer.png' height=20>;
|
|
try ``python3 run.py --task [description_of_your_idea] --config "Human"``. See [guide](wiki.md#human-agent-interaction) and [example](WareHouse/Gomoku_HumanAgentInteraction_20230920135038).
|
|
<p align="center">
|
|
<img src='./misc/Human_intro.png' width=600>
|
|
</p>
|
|
* September 1st, 2023: The **Art** mode is available now! You can activate the designer agent <img src='online_log/static/figures/designer.png' height=20> to generate images used in the software;
|
|
try ``python3 run.py --task [description_of_your_idea] --config "Art"``. See [guide](wiki.md#art) and [example](WareHouse/gomokugameArtExample_THUNLP_20230831122822).
|
|
* August 28th, 2023: The system is publicly available.
|
|
* August 17th, 2023: The v1.0.0 version was ready for release.
|
|
* July 30th, 2023: Users can customize ChatChain, Phase, and Role settings. Additionally, both online Log mode and replay
|
|
mode are now supported.
|
|
* July 16th, 2023: The [preprint paper](https://arxiv.org/abs/2307.07924) associated with this project was published.
|
|
* June 30th, 2023: The initial version of the ChatDev repository was released.
|
|
|
|
## ❓ What Can ChatDev Do?
|
|
|
|
|
|
|
|
https://github.com/OpenBMB/ChatDev/assets/11889052/80d01d2f-677b-4399-ad8b-f7af9bb62b72
|
|
|
|
## ⚡️ Quickstart
|
|
|
|
To get started, follow these steps:
|
|
|
|
1. **Clone the GitHub Repository:** Begin by cloning the repository using the command:
|
|
```
|
|
git clone https://github.com/OpenBMB/ChatDev.git
|
|
```
|
|
2. **Set Up Python Environment:** Ensure you have a version 3.9 or higher Python environment. You can create and
|
|
activate this environment using the following commands, replacing `ChatDev_conda_env` with your preferred environment
|
|
name:
|
|
```
|
|
conda create -n ChatDev_conda_env python=3.9 -y
|
|
conda activate ChatDev_conda_env
|
|
```
|
|
3. **Install Dependencies:** Move into the `ChatDev` directory and install the necessary dependencies by running:
|
|
```
|
|
cd ChatDev
|
|
pip3 install -r requirements.txt
|
|
```
|
|
4. **Set OpenAI API Key:** Export your OpenAI API key as an environment variable. Replace `"your_OpenAI_API_key"` with
|
|
your actual API key. Remember that this environment variable is session-specific, so you need to set it again if you
|
|
open a new terminal session.
|
|
On Unix/Linux:
|
|
```
|
|
export OPENAI_API_KEY="your_OpenAI_API_key"
|
|
```
|
|
On Windows:
|
|
```
|
|
$env:OPENAI_API_KEY="your_OpenAI_API_key"
|
|
```
|
|
5. **Build Your Software:** Use the following command to initiate the building of your software,
|
|
replacing `[description_of_your_idea]` with your idea's description and `[project_name]` with your desired project
|
|
name:
|
|
On Unix/Linux:
|
|
```
|
|
python3 run.py --task "[description_of_your_idea]" --name "[project_name]"
|
|
```
|
|
On Windows:
|
|
```
|
|
python run.py --task "[description_of_your_idea]" --name "[project_name]"
|
|
```
|
|
6. **Run Your Software:** Once generated, you can find your software in the `WareHouse` directory under a specific
|
|
project folder, such as `project_name_DefaultOrganization_timestamp`. Run your software using the following command
|
|
within that directory:
|
|
On Unix/Linux:
|
|
```
|
|
cd WareHouse/project_name_DefaultOrganization_timestamp
|
|
python3 main.py
|
|
```
|
|
On Windows:
|
|
```
|
|
cd WareHouse/project_name_DefaultOrganization_timestamp
|
|
python main.py
|
|
```
|
|
|
|
## ✨️ Advanced Skills
|
|
|
|
For more detailed information, please refer to our [Wiki](wiki.md), where you can find:
|
|
|
|
- An introduction to all command run parameters.
|
|
- A straightforward guide for setting up a local web demo, which includes enhanced visualized logs, a replay demo, and a
|
|
simple ChatChain Visualizer.
|
|
- An overview of the ChatDev framework.
|
|
- A comprehensive introduction to all advanced parameters in ChatChain configuration.
|
|
- Guides for customizing ChatDev, including:
|
|
- ChatChain: Design your own software development process (or any other process), such
|
|
as ``DemandAnalysis -> Coding -> Testing -> Manual``.
|
|
- Phase: Design your own phase within ChatChain, like ``DemandAnalysis``.
|
|
- Role: Defining the various agents in your company, such as the ``Chief Executive Officer``.
|
|
|
|
## 🤗 Share Your Software!
|
|
|
|
**Code**: We are enthusiastic about your interest in participating in our open-source project. If you come across any
|
|
problems, don't hesitate to report them. Feel free to create a pull request if you have any inquiries or if you are
|
|
prepared to share your work with us! Your contributions are highly valued. Please let me know if there's anything else
|
|
you need assistance!
|
|
|
|
**Company**: Creating your own customized "ChatDev Company" is a breeze. This personalized setup involves three simple
|
|
configuration JSON files. Check out the example provided in the ``CompanyConfig/Default`` directory. For detailed
|
|
instructions on customization, refer to our [Wiki](wiki.md).
|
|
|
|
**Software**: Whenever you develop software using ChatDev, a corresponding folder is generated containing all the
|
|
essential information. Sharing your work with us is as simple as making a pull request. Here's an example: execute the
|
|
command ``python3 run.py --task "design a 2048 game" --name "2048" --org "THUNLP" --config "Default"``. This will
|
|
create a software package and generate a folder named ``/WareHouse/2048_THUNLP_timestamp``. Inside, you'll find:
|
|
|
|
- All the files and documents related to the 2048 game software
|
|
- Configuration files of the company responsible for this software, including the three JSON config files
|
|
from ``CompanyConfig/Default``
|
|
- A comprehensive log detailing the software's building process that can be used to replay (``timestamp.log``)
|
|
- The initial prompt used to create this software (``2048.prompt``)
|
|
|
|
**See community contributed software [here](Contribution.md)!**
|
|
|
|
## 👨💻 Contributors
|
|
|
|
<a href="https://github.com/OpenBMB/ChatDev/graphs/contributors">
|
|
<img src="https://contrib.rocks/image?repo=OpenBMB/ChatDev" />
|
|
</a>
|
|
|
|
Made with [contrib.rocks](https://contrib.rocks).
|
|
## 🔎 Citation
|
|
|
|
```
|
|
@misc{qian2023communicative,
|
|
title={Communicative Agents for Software Development},
|
|
author={Chen Qian and Xin Cong and Wei Liu and Cheng Yang and Weize Chen and Yusheng Su and Yufan Dang and Jiahao Li and Juyuan Xu and Dahai Li and Zhiyuan Liu and Maosong Sun},
|
|
year={2023},
|
|
eprint={2307.07924},
|
|
archivePrefix={arXiv},
|
|
primaryClass={cs.SE}
|
|
}
|
|
```
|
|
|
|
## ⚖️ License
|
|
|
|
- Source Code Licensing: Our project's source code is licensed under the Apache 2.0 License. This license permits the use, modification, and distribution of the code, subject to certain conditions outlined in the Apache 2.0 License.
|
|
- Project Open-Source Status: The project is indeed open-source; however, this designation is primarily intended for non-commercial purposes. While we encourage collaboration and contributions from the community for research and non-commercial applications, it is important to note that any utilization of the project's components for commercial purposes necessitates separate licensing agreements.
|
|
- Data Licensing: The related data utilized in our project is licensed under CC BY-NC 4.0. This license explicitly permits non-commercial use of the data. We would like to emphasize that any models trained using these datasets should strictly adhere to the non-commercial usage restriction and should be employed exclusively for research purposes.
|
|
|
|
## 🌟 Star History
|
|
|
|
[](https://star-history.com/#openbmb/chatdev&Date)
|
|
|
|
|
|
## 🤝 Acknowledgments
|
|
<a href="http://nlp.csai.tsinghua.edu.cn/"><img src="misc/thunlp.png" height=50pt></a>
|
|
<a href="https://modelbest.cn/"><img src="misc/modelbest.png" height=50pt></a>
|
|
<a href="https://github.com/OpenBMB/AgentVerse/"><img src="misc/agentverse.png" height=50pt></a>
|
|
<a href="https://aibrb.com/introducing-herbie-your-super-employee-for-streamlined-productivity/"><img src="https://aibrb.com/wp-content/uploads/2023/09/Featured-on-AIBRB.com-white-1.png" height=50pt></a>
|
|
|
|
## 📬 Contact
|
|
|
|
If you have any questions, feedback, or would like to get in touch, please feel free to reach out to us via email at [chatdev.openbmb@outlook.com](mailto:chatdev.openbmb@outlook.com)
|