uodate redame

This commit is contained in:
钱忱 2023-10-11 14:42:31 +08:00
parent 058229f91d
commit a00518287d
9 changed files with 575 additions and 9 deletions

View File

@ -1,11 +1,15 @@
# Communicative Agents for Software Development
<p align="center"> <img src='./misc/logo1.png' width=600> </p>
<p align="center">
<a href="README.md">English</a> | Chinese | <a href="README-Japanese.md">Japanese</a> | <a href="README-Korean.md">Korean</a> | <a href="README-Filipino.md">Filipino</a> | <a href="README-French.md">French</a>
<img src='./misc/logo1.png' width=600>
</p>
<p align="center">
<a href="README.md">English</a> | Chinese | <a href="README-Japanese.md">Japanese</a> | <a href="README-Korean.md">Korean</a> | <a href="README-Filipino.md">Filipino</a> | <a href="README-French.md">French</a> | <a href="README-Slovak.md">Slovak</a> | <a href="README-Portuguese.md">Portuguese</a> | <a href="README-Spanish.md">Spanish</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>
## 📖 概述
- **ChatDev** 是一家**虚拟软件公司**,通过各种不同角色的**智能体**

View File

@ -5,9 +5,8 @@
</p>
<p align="center">
<a href="README.md">English</a> | <a href="README-Chinese.md">Chinese</a> | <a href="README-Japanese.md">Japanese</a> | <a href="README-Korean.md">Korean</a> | Filipino | <a href="README-French.md">French</a>
<a href="README.md">English</a> | <a href="README-Chinese.md">Chinese</a> | <a href="README-Japanese.md">Japanese</a> | <a href="README-Korean.md">Korean</a> | Filipino | <a href="README-French.md">French</a> | <a href="README-Slovak.md">Slovak</a> | <a href="README-Portuguese.md">Portuguese</a> | <a href="README-Spanish.md">Spanish</a>
</p>
<p align="center">
【📚 <a href="wiki.md">Wiki</a> | 🚀 <a href="wiki.md#local-demo">Lokal na Demo</a> | 👥 <a href="Contribution.md">Komunidad ng Kontribusyon sa Software</a> | 🔧 <a href="wiki.md#customization">Kostomisasyon</a>
</p>

View File

@ -5,7 +5,7 @@
</p>
<p align="center">
<a href="README.md">English</a> | <a href="README-Chinese.md">Chinese</a> | <a href="README-Japanese.md">Japanese</a> | <a href="README-Korean.md">Korean</a> | <a href="README-Filipino.md">Filipino</a> | French 】
<a href="README.md">English</a> | <a href="README-Chinese.md">Chinese</a> | <a href="README-Japanese.md">Japanese</a> | <a href="README-Korean.md">Korean</a> | <a href="README-Filipino.md">Filipino</a> | French | <a href="README-Slovak.md">Slovak</a> | <a href="README-Portuguese.md">Portuguese</a> | <a href="README-Spanish.md">Spanish</a>
</p>
<p align="center">
【📚 <a href="wiki.md">Wiki</a> | 🚀 <a href="wiki.md#local-demo">Démo Locale</a> | 👥 <a href="Contribution.md">Logiciels de la Communauté</a> | 🔧 <a href="wiki.md#customization">Personnalisation</a>

View File

@ -5,7 +5,7 @@
</p>
<p align="center">
<a href="README.md">English</a> | <a href="README-Chinese.md">Chinese</a> | Japanese | <a href="README-Korean.md">Korean</a> | <a href="README-Filipino.md">Filipino</a> | <a href="README-French.md">French</a>
<a href="README.md">English</a> | <a href="README-Chinese.md">Chinese</a> | Japanese | <a href="README-Korean.md">Korean</a> | <a href="README-Filipino.md">Filipino</a> | <a href="README-French.md">French</a> | <a href="README-Slovak.md">Slovak</a> | <a href="README-Portuguese.md">Portuguese</a> | <a href="README-Spanish.md">Spanish</a>
</p>
<p align="center">
【📚 <a href="wiki.md">Wiki</a> | 🚀 <a href="wiki.md#local-demo">ローカルデモ</a> | 👥 <a href="Contribution.md">コミュニティにより作られたソフト</a> | 🔧 <a href="wiki.md#customization">カスタマイズ</a>

View File

@ -5,7 +5,10 @@
</p>
<p align="center">
<a href="README.md">English</a> | <a href="README-Chinese.md">Chinese</a> | <a href="README-Japanese.md">Japanese</a> | Korean | <a href="README-Filipino.md">Filipino</a> | <a href="README-French.md">French</a>
<a href="README.md">English</a> | <a href="README-Chinese.md">Chinese</a> | <a href="README-Japanese.md">Japanese</a> | Korean | <a href="README-Filipino.md">Filipino</a> | <a href="README-French.md">French</a> | <a href="README-Slovak.md">Slovak</a> | <a href="README-Portuguese.md">Portuguese</a> | <a href="README-Spanish.md">Spanish</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>
## 📖 개요

182
README-Portuguese.md Normal file
View File

@ -0,0 +1,182 @@
# Communicative Agents for Software Development
<p align="center">
<img src='./misc/logo1.png' width=550>
</p>
<p align="center">
<a href="README.md">English</a> | <a href="README-Chinese.md">Chinese</a> | <a href="README-Japanese.md">Japanese</a> | <a href="README-Korean.md">Korean</a> | <a href="README-Filipino.md">Filipino</a> | <a href="README-French.md">French</a> | <a href="README-Slovak.md">Slovak</a> | Portuguese | <a href="README-Spanish.md">Spanish</a>
</p>
<p align="center">
【📚 <a href="wiki.md">Wiki</a> | 🚀 <a href="wiki.md#local-demo">Demo Local</a> | 👥 <a href="Contribution.md">Software Construído pela Comunidade</a> | 🔧 <a href="wiki.md#customization">Personalização</a>
</p>
## 📖 Overview
- **ChatDev** é uma **empresa de software virtual** que opera por meio de vários **agentes inteligentes** desempenhando
diferentes papéis, incluindo Diretor Executivo <img src='online_log/static/figures/ceo.png' height=20>, Diretor de Produtos <img src='online_log/static/figures/cpo.png' height=20>, Diretor de Tecnologia <img src='online_log/static/figures/cto.png' height=20>, programador <img src='online_log/static/figures/programmer.png' height=20>, revisor <img src='online_log/static/figures/reviewer.png' height=20>, testador <img src='online_log/static/figures/tester.png' height=20>, designer de arte <img src='online_log/static/figures/designer.png' height=20>. Esses
agentes formam uma estrutura organizacional multiagente e estão unidos por uma missão de "revolucionar o mundo digital
por meio da programação." Os agentes dentro do ChatDev **colaboram** participando de seminários funcionais especializados,
incluindo tarefas como design, codificação, teste e documentação.
- O objetivo principal do ChatDev é oferecer um framework **fácil de usar**, **altamente personalizável** e **extensível**, baseado em modelos de linguagem grandes (LLMs) e que serve como um cenário ideal para estudar a inteligência coletiva.
<p align="center">
<img src='./misc/company.png' width=600>
</p>
## 🎉 Notícias
* **25 de setembro de 2023: A funcionalidade Git agora está disponível**, permitindo que o programador <img src='online_log/static/figures/programmer.png' height=20> utilize o GitHub para controle de versão. Para ativar essa funcionalidade, basta definir ``"git_management"`` para ``"True"`` no arquivo ``ChatChainConfig.json``.
<p align="center">
<img src='./misc/github.png' width=600>
</p>
* 20 de setembro de 2023: O modo **Interação Humano-Agent** agora está disponível! Você pode se envolver com a equipe do ChatDev desempenhando o papel de revisor <img src='online_log/static/figures/reviewer.png' height=20> e fazendo sugestões ao programador <img src='online_log/static/figures/programmer.png' height=20>;
tente ``python3 run.py --task [descrição_da_sua_ideia] --config "Human"``. Veja [guia](wiki.md#human-agent-interaction) e [exemplo](WareHouse/Gomoku_HumanAgentInteraction_20230920135038).
<p align="center">
<img src='./misc/Human_intro.png' width=600>
</p>
* 1º de setembro de 2023: O modo **Arte** está disponível agora! Você pode ativar o agente designer <img src='online_log/static/figures/designer.png' height=20> para gerar imagens usadas no software;
try ``python3 run.py --task [descrição_da_sua_ideia] --config "Art"``. Veja o [guia](wiki.md#art) e o [exemplo](WareHouse/gomokugameArtExample_THUNLP_20230831122822).
* 28 de agosto de 2023: O sistema está disponível publicamente.
* 17 de agosto de 2023: A versão v1.0.0 estava pronta para ser lançada.
* 30 de julho de 2023: Os usuários podem personalizar as configurações do * ChatChain, Fase e Papel. Além disso, o modo de Log online e o modo de replay * agora são suportados.
* 16 de julho de 2023: O artigo preliminar associado a este projeto foi * publicado.
* 30 de junho de 2023: A versão inicial do repositório do ChatDev foi lançada.
## ❓ O Que o ChatDev Pode Fazer?
![Introdução](misc/intro.png)
https://github.com/OpenBMB/ChatDev/assets/11889052/80d01d2f-677b-4399-ad8b-f7af9bb62b72
## ⚡️ Início Rápido
Para começar, siga estas etapas:
1. **Clone o Repositório do GitHub:** Comece clonando o repositório usando o comando:
```
git clone https://github.com/OpenBMB/ChatDev.git
```
2. **Configurar o Ambiente Python:** Verifique se você tem um ambiente Python versão 3.9 ou superior. Você pode criar e
ativar este ambiente usando os seguintes comandos, substituindo `ChatDev_conda_env` pelo nome do ambiente de sua
preferência:
```
conda create -n ChatDev_conda_env python=3.9 -y
conda activate ChatDev_conda_env
```
3. **Instalar Dependências:** Mova-se para o diretório `ChatDev` e instale as dependências necessárias executando:
```
cd ChatDev
pip3 install -r requirements.txt
```
4. **Inicializando as chaves da OpenAI API:** Exporte sua chave OpenAI API como uma variável de ambiente. Substitua `"your_OpenAI_API_key"` com sua chave API atual. Lembre-se de que esta variável de ambiente é apenas para esta sessão, portanto, você precisa defini-la novamente se abrir uma nova sessão de terminal.
No Unix/Linux:
```
export OPENAI_API_KEY="your_OpenAI_API_key"
```
No Windows:
```
$env:OPENAI_API_KEY="your_OpenAI_API_key"
```
5. **Construir o Seu Software:** Use o seguinte comando para iniciar a construção do seu software, substituindo
`[descrição_da_sua_ideia]` pela descrição da sua ideia e `[nome_do_projeto]` pelo nome do projeto desejado:
No Unix/Linux:
```
python3 run.py --task "[descrição_da_sua_ideia]" --name "[nome_do_projeto]"
```
No Windows:
```
python run.py --task "[descrição_da_sua_ideia]" --name "[nome_do_projeto]"
```
6. **Executar o Seu Software:** Uma vez gerado, você pode encontrar seu software no diretório `WareHouse` sob uma pasta
de projeto específica, como `project_name_DefaultOrganization_timestamp`. Execute seu software usando o seguinte
comando dentro desse diretório:
No Unix/Linux:
```
cd WareHouse/project_name_DefaultOrganization_timestamp
python3 main.py
```
No Windows:
```
cd WareHouse/project_name_DefaultOrganization_timestamp
python main.py
```
## ✨️ Habilidades Avançadas
Para obter informações mais detalhadas, consulte nossa Wiki, onde você pode encontrar:
- Uma introdução a todos os parâmetros de execução de comandos.
- Um guia direto para configurar um demo web local, que inclui logs visualizados aprimorados, um demo de replay e um ChatChain Visualizer simples.
- Uma visão geral do framework ChatDev.
- Uma introdução abrangente a todos os parâmetros avançados na configuração do ChatChain.
- Guias para personalizar o ChatDev, incluindo:
- ChatChain: Projete seu próprio processo de desenvolvimento de software (ou qualquer outro processo), como ``Análise de Demanda -> Codificação -> Teste -> Manual``.
- Fase: Projete sua própria fase dentro do ChatChain, como ``Análise de Demanda``.
- Papel: Defina os diversos agentes em sua empresa, como ``Diretor Executivo``.
## 🤗 Compartilhe seu Software!
**Código**: Estamos entusiasmados com seu interesse em participar de nosso projeto de código aberto. Se você encontrar algum problema, não hesite em relatá-lo. Sinta-se à vontade para criar uma solicitação pull se tiver alguma dúvida ou se estiver pronto para compartilhar seu trabalho conosco! Suas contribuições são altamente valorizadas. Por favor, avise se houver mais alguma coisa que você precisa de ajuda!
**Empresa**: Criar sua própria "Empresa ChatDev" personalizada é fácil. Essa configuração personalizada envolve três arquivos JSON de configuração simples. Confira o exemplo fornecido no diretório ``CompanyConfig/Default``. Para instruções detalhadas sobre personalização, consulte nossa [Wiki](wiki.md).
**Software**: Sempre que você desenvolve software usando o ChatDev, é gerada uma pasta correspondente contendo todas as informações essenciais. Compartilhar seu trabalho conosco é tão simples quanto criar uma solicitação pull. Aqui está um exemplo: execute o comando ``python3 run.py --task "design a 2048 game" --name "2048" --org "THUNLP" --config "Default"``. Isso criará um pacote de software e gerará uma pasta chamada ``/WareHouse/2048_THUNLP_timestamp``. Dentro dela, você encontrará:
- Todos os arquivos e documentos relacionados ao software do jogo 2048
- Arquivos de configuração da empresa responsável por este software, incluindo os três arquivos JSON de configuração de ``CompanyConfig/Default``
- Um registro abrangente detalhando o processo de construção do software que pode ser usado para replay (``timestamp.log``)
- A prompt inicial usada para criar este software (``2048.prompt``)
**Veja o software contribuído pela comunidade [aqui](Contribution.md)!**
## 👨‍💻‍ Contribuidores de Software
<a href="https://github.com/qianc62"><img src="https://avatars.githubusercontent.com/u/48988402?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/thinkwee"><img src="https://avatars.githubusercontent.com/u/11889052?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/NA-Wen"><img src="https://avatars.githubusercontent.com/u/92134380?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/JiahaoLi2003"><img src="https://avatars.githubusercontent.com/u/111221887?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/Alphamasterliu"><img src="https://avatars.githubusercontent.com/u/110011045?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/GeekyWizKid"><img src="https://avatars.githubusercontent.com/u/133981481?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/Munsif-Raza-T"><img src="https://avatars.githubusercontent.com/u/76085202?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/djbritt"><img src="https://avatars.githubusercontent.com/u/28036018?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/Classified3939"><img src="https://avatars.githubusercontent.com/u/102702965?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/chenilim"><img src="https://avatars.githubusercontent.com/u/46905241?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/delconis"><img src="https://avatars.githubusercontent.com/u/5824478?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/eMcQuill"><img src="https://avatars.githubusercontent.com/u/139025701?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
## 🔎 Citação
```
@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}
}
```
## ⚖️ Licença
- Licenciamento de Código Fonte: O código fonte de nosso projeto está licenciado sob a Licença Apache 2.0. Esta licença permite o uso, modificação e distribuição do código, sujeito a certas condições delineadas na Licença Apache 2.0.
- Status de Código Aberto do Projeto: O projeto é de fato de código aberto; no entanto, essa designação se destina principalmente a fins não comerciais. Embora encorajemos a colaboração e contribuições da comunidade para fins de pesquisa e aplicações não comerciais, é importante observar que qualquer uso dos componentes do projeto para fins comerciais requer acordos de licenciamento separados.
- Licenciamento de Dados: Os dados relacionados usados em nosso projeto estão licenciados sob CC BY-NC 4.0. Esta licença permite explicitamente o uso não comercial dos dados. Gostaríamos de enfatizar que qualquer modelo treinado usando esses conjuntos de dados deve aderir estritamente à restrição de uso não comercial e deve ser usado exclusivamente para fins de pesquisa.
## 🌟 Histórico de Estrelas
[![Star History Chart](https://api.star-history.com/svg?repos=openbmb/chatdev&type=Date)](https://star-history.com/#openbmb/chatdev&Date)
## 🤝 Agradecimentos
<a href="http://nlp.csai.tsinghua.edu.cn/"><img src="misc/thunlp.png" height=50pt></a>&nbsp;&nbsp;
<a href="https://modelbest.cn/"><img src="misc/modelbest.png" height=50pt></a>&nbsp;&nbsp;
<a href="https://github.com/OpenBMB/AgentVerse/"><img src="misc/agentverse.png" height=50pt></a>&nbsp;&nbsp;
<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>
## 📬 Contato
Se você tiver alguma dúvida, feedback ou gostaria de entrar em contato, não hesite em nos enviar um e-mail para [chatdev.openbmb@outlook.com](mailto:chatdev.openbmb@outlook.com)

192
README-Slovak.md Normal file
View File

@ -0,0 +1,192 @@
# Communicative Agents for Software Development
<p align="center">
<img src='./misc/logo1.png' width=550>
</p>
<p align="center">
<a href="README.md">English</a> | <a href="README-Chinese.md">Chinese</a> | <a href="README-Japanese.md">Japanese</a> | <a href="README-Korean.md">Korean</a> | <a href="README-Filipino.md">Filipino</a> | <a href="README-French.md">French</a> | Slovak | <a href="README-Portuguese.md">Portuguese</a> | <a href="README-Spanish.md">Spanish</a>
</p>
<p align="center">
【📚 <a href="wiki.md">Wiki</a> | 🚀 <a href="wiki.md#local-demo">Lokalne Demo</a> | 👥 <a href="Contribution.md">Softvér vytvorený komunitou</a> | 🔧 <a href="wiki.md#customization">Prispôsobenie</a>
</p>
## 📖 Prehľad
- **ChatDev** je **virtuálna softvérová spoločnosť**, ktorá pôsobí prostredníctvom rôznych **inteligentných agentov**.
rôznych funkcií, vrátane riaditeľa <img src='online_log/static/figures/ceo.png' height=20>, produktového riaditeľa <img src='online_log/static/figures/cpo.png' height=20>, technologického riaditeľa <img src="online_log/static/figures/cto.png" height=20>, programátor <img src='online_log/static/figures/programmer.png' height=20>, recenzent <img src='online_log/static/figures/reviewer.png' height=20>, tester <img src='online_log/static/figures/tester.png' height=20>, výtvarník <img src='online_log/static/figures/designer.png' height=20>. Týto
agenti tvoria multiagentovú organizačnú štruktúru a spája ich poslanie "revolučne zmeniť digitálny svet
prostredníctvom programovania." Agenti v rámci ChatDev **spolupracujú** účasťou na špecializovaných funkčných seminároch,
vrátane úloh, ako je navrhovanie, kódovanie, testovanie a dokumentovanie.
- Hlavným cieľom ChatDev je ponúknuť **jednoduchý**, **vysoko prispôsobiteľný** a **rozšíriteľný** framework,
ktorý je založený na veľkých jazykových modeloch (LLM) a slúži ako ideálny scenár na štúdium kolektívnej inteligencie.
<p align="center">
<img src='./misc/company.png' width=600>
</p>
## 🎉 Novinky
* september 25. 2023: Teraz je k dispozícii funkcia **Git**, ktorá umožňuje programátorovi <img src='online_log/static/figures/programmer.png' height=20> využívať GitHub na version control. Ak chcete túto funkciu povoliť, jednoducho nastavte ``"git_management"`` na ``"True"`` v súbore ``ChatChainConfig.json``.
<p align="center">
<img src='./misc/github.png' width=600>
</p>
* september 20. 2023: Režim **Human-Agent-Interaction** je teraz k dispozícii! Môžete sa zapojiť do tímu ChatDev tým, že budete hrať úlohu recenzenta <img src='online_log/static/figures/reviewer.png' height=20> a predkladať návrhy programátorovi <img src='online_log/static/figures/programmer.png' height=20>;
skúste ``python3 run.py --task [description_of_your_idea] --config "Human"``. Pozri [návod](wiki.md#human-agent-interaction) a [príklad](WareHouse/Gomoku_HumanAgentInteraction_20230920135038).
<p align="center">
<img src='./misc/Human_intro.png' width=600>
</p>
* september 1. 2023: Režim **Art** je už k dispozícii! Môžete si aktivovať agenta dizajnéra <img src='online_log/static/figures/designer.png' height=20> na generovanie obrázkov používaných v programe;
skúste ``python3 run.py --task [description_of_your_idea] --config "Art"``. Pozri [návod](wiki.md#art) a [príklad](WareHouse/gomokugameArtExample_THUNLP_20230831122822).
* august 28. 2023: Systém je verejne dostupný.
* august 17. 2023: Verzia v1.0.0 bola pripravená na vydanie.
* júl 30. 2023: Používatelia si môžu prispôsobiť nastavenia ChatChain, Phase a Role. Okrem toho je k dispozícii režim online záznamu aj replay
režim sú teraz podporované.
* júl 16. 2023: Bol uverejnený článok [preprint paper](https://arxiv.org/abs/2307.07924) súvisiaci s týmto projektom.
* jún 30. 2023: Bola vydaná počiatočná verzia repozitára ChatDev.
## ❓ Čo dokáže ChatDev?
![intro](misc/intro.png)
https://github.com/OpenBMB/ChatDev/assets/11889052/80d01d2f-677b-4399-ad8b-f7af9bb62b72
## ⚡️ Rýchly štart
Ak chcete začať, postupujte podľa týchto krokov:
1. **Naklonovať GitHub repozitár:** Začnite klonovaním repozitára pomocou príkazu:
```
git clone https://github.com/OpenBMB/ChatDev.git
```
2. **Nastavenie prostredia Python:** Uistite sa, že máte prostredie Python vo verzii 3.9 alebo vyššej. Môžete vytvoriť a
aktivovať toto prostredie pomocou nasledujúcich príkazov, pričom `ChatDev_conda_env` nahradíte preferovaným menom prostredia
:
```
conda create -n ChatDev_conda_env python=3.9 -y
conda activate ChatDev_conda_env
```
3. **inštalácia knižníc:** Presuňte sa do adresára `ChatDev` a nainštalujte potrebné knižnice spustením:
```
cd ChatDev
pip3 install -r requirements.txt
```
4. **Nastavenie kľúča API OpenAI:** Exportujte svoj kľúč API OpenAI ako premennú prostredia. Nahraďte `"vas_OpenAI_API_kluc"`
svojím skutočným kľúčom API. **Nezabudnite, že táto premenná prostredia je špecifická pre reláciu, takže ju musíte nastaviť znova, ak**
**otvoríte novú reláciu terminálu.**
V systéme Unix/Linux:
```
export OPENAI_API_KEY="vas_OpenAI_API_kluc"
```
V systéme Windows:
```
$env:OPENAI_API_KEY="vas_OpenAI_API_kluc"
```
5. **Generovanie softvéru:** Na spustenie generovania softvéru použite nasledujúci príkaz,
pričom `[popis_vášho_nápadu]` nahradíte opisom svojho nápadu a `[meno_projektu]` požadovaným menom projektu:
Na systéme Unix/Linux:
```
python3 run.py --task "[popis_vášho_nápadu]" --name "[meno_projektu]"
```
Na systéme Windows:
```
python run.py --task "[popis_vášho_nápadu]" --name "[meno_projektu]"
```
6. **Spustenie softvéru:** Po vygenerovaní nájdete svoj softvér v adresári `WareHouse` pod konkrétnym
priečinku projektu, napríklad `moj_projekt_DefaultOrganization_20231010224405`. Spustite svoj softvér pomocou nasledujúceho príkazu
v tomto adresári:
V systéme Unix/Linux:
```
cd WareHouse/moj_projekt_DefaultOrganization_20231010224405
python3 main.py
```
Na Windowse
```
cd WareHouse/moj_projekt_DefaultOrganization_20231010224405
python main.py
```
## ✨️ Pokročilé zručnosti
Podrobnejšie informácie nájdete na našej [Wiki](wiki.md), kde nájdete:
- Úvod do všetkých parametrov spúšťania príkazov.
- Jednoduchý návod na nastavenie miestnej webovej ukážky, ktorá obsahuje rozšírené vizualizované protokoly, ukážku prehrávania a
jednoduchý vizualizér ChatChain.
- Prehľad ChatDev frameworku.
- Komplexný úvod do všetkých pokročilých parametrov konfigurácie ChatChain.
- Návody na prispôsobenie ChatDev vrátane:
- ChatChain: Navrhnite si vlastný proces vývoja softvéru (alebo akýkoľvek iný proces), napr.
ako ``Analýza dopytu -> Kódovanie -> Testovanie -> Manuálne``.
- Fáza: Navrhnite si vlastnú fázu v rámci ChatChain, napríklad ``DemandAnalysis``.
- Rola: Definovanie rôznych zástupcov vo vašej spoločnosti, napríklad ``Hlavný výkonný riaditeľ``.
## 🤗 Zdieľajte svoj softvér!
**Kód**: Sme nadšení z vášho záujmu o účasť na našom open-source projekte. Ak narazíte na akýkoľvek
problémy, neváhajte ich nahlásiť. Neváhajte a vytvorte žiadosť o stiahnutie, ak máte nejaké otázky alebo ak ste
pripravení podeliť sa s nami o svoju prácu! Vaše príspevky si veľmi ceníme. Dajte mi prosím vedieť, ak potrebujete pomoc!
**Spoločnosť**: Vytvorenie vlastnej prispôsobenej "ChatDev Company" je hračka. Toto personalizované nastavenie zahŕňa tri jednoduché
konfiguračné súbory JSON. Pozrite si príklad uvedený v adresári ``CompanyConfig/Default``. Podrobný
návod na prispôsobenie nájdete na našej [Wiki](wiki.md).
**Softvér**: Vždy, keď vyvíjate softvér pomocou ChatDev, vytvorí sa príslušný priečinok obsahujúci všetky
dôležité informácie. Zdieľanie vašej práce s nami je také jednoduché ako pull request. Tu je príklad: vykonajte
príkaz ``python3 run.py --task "design a 2048 game" --name "2048" --org "THUNLP" --config "Default"``. Tým sa
vytvorí softvérový balík a vygeneruje priečinok s názvom ``/WareHouse/2048_THUNLP_timestamp``. V ňom nájdete:
- Všetky súbory a dokumenty týkajúce sa softvéru hry 2048
- Konfiguračné súbory spoločnosti zodpovednej za tento softvér vrátane troch konfiguračných súborov JSON
z ``CompanyConfig/Default``
- Komplexný protokol s podrobnými informáciami o procese vytvárania softvéru, ktorý možno použiť na prehrávanie (``timestamp.log``)
- Počiatočny "prompt" alebo zadanie použite na vytvorenie tohto softvéru (``2048.prompt``)
**Pozrite si softvér poskytnutý komunitou [tu](Contribution.md)!**
## 👨‍💻‍ Kontributory softvéru
<a href="https://github.com/qianc62"><img src="https://avatars.githubusercontent.com/u/48988402?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/thinkwee"><img src="https://avatars.githubusercontent.com/u/11889052?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/NA-Wen"><img src="https://avatars.githubusercontent.com/u/92134380?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/JiahaoLi2003"><img src="https://avatars.githubusercontent.com/u/111221887?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/Alphamasterliu"><img src="https://avatars.githubusercontent.com/u/110011045?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/GeekyWizKid"><img src="https://avatars.githubusercontent.com/u/133981481?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/Munsif-Raza-T"><img src="https://avatars.githubusercontent.com/u/76085202?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/djbritt"><img src="https://avatars.githubusercontent.com/u/28036018?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/Classified3939"><img src="https://avatars.githubusercontent.com/u/102702965?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/chenilim"><img src="https://avatars.githubusercontent.com/u/46905241?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/delconis"><img src="https://avatars.githubusercontent.com/u/5824478?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/eMcQuill"><img src="https://avatars.githubusercontent.com/u/139025701?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
## 🔎 Citát
```
@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
- Licencovanie zdrojového kódu: Zdrojový kód nášho projektu je licencovaný pod licenciou Apache 2.0. Táto licencia povoľuje používanie, modifikáciu a šírenie kódu za určitých podmienok uvedených v licencii Apache 2.0.
- Stav projektu ako open-source: Projekt je skutočne open-source, toto označenie je však primárne určené na nekomerčné účely. Hoci podporujeme spoluprácu a príspevky komunity na výskum a nekomerčné aplikácie, je dôležité poznamenať, že akékoľvek využitie komponentov projektu na komerčné účely si vyžaduje samostatné licenčné zmluvy.
- Licencovanie údajov: Súvisiace údaje použité v našom projekte sú licencované pod CC BY-NC 4.0. Táto licencia výslovne povoľuje nekomerčné použitie údajov. Chceli by sme zdôrazniť, že akékoľvek modely vycvičené pomocou týchto súborov údajov by mali striktne dodržiavať obmedzenie nekomerčného použitia a mali by sa používať výlučne na výskumné účely.
## 🌟 Star Historia
[![Star History Chart](https://api.star-history.com/svg?repos=openbmb/chatdev&type=Date)](https://star-history.com/#openbmb/chatdev&Date)
## 🤝 Poďakovania
<a href="http://nlp.csai.tsinghua.edu.cn/"><img src="misc/thunlp.png" height=50pt></a>&nbsp;&nbsp;
<a href="https://modelbest.cn/"><img src="misc/modelbest.png" height=50pt></a>&nbsp;&nbsp;
<a href="https://github.com/OpenBMB/AgentVerse/"><img src="misc/agentverse.png" height=50pt></a>&nbsp;&nbsp;
<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>
## 📬 Kontakt
Ak máte akékoľvek otázky, spätnú väzbu alebo by ste nás chceli kontaktovať, neváhajte nás kontaktovať e-mailom na adrese [chatdev.openbmb@outlook.com](mailto:chatdev.openbmb@outlook.com)

186
README-Spanish.md Normal file
View File

@ -0,0 +1,186 @@
# Communicative Agents for Software Development
<p align="center">
<img src='./misc/logo1.png' width=550>
</p>
<p align="center">
<a href="README.md">English</a> | <a href="README-Chinese.md">Chinese</a> | <a href="README-Japanese.md">Japanese</a> | <a href="README-Korean.md">Korean</a> | <a href="README-Filipino.md">Filipino</a> | <a href="README-French.md">French</a> | <a href="README-Slovak.md">Slovak</a> | <a href="README-Portuguese.md">Portuguese</a> | Spanish】
</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** es una **empresa de software virtual** que opera a través de varios **agentes inteligentes** que desempeñan diferentes roles, incluyendo al Director Ejecutivo <img src='online_log/static/figures/ceo.png' height=20>, Director de Producto <img src='online_log/static/figures/cpo.png' height=20>, Director Tecnológico <img src='online_log/static/figures/cto.png' height=20>, programador <img src='online_log/static/figures/programmer.png' height=20>, revisor <img src='online_log/static/figures/reviewer.png' height=20>, tester <img src='online_log/static/figures/tester.png' height=20>, diseñador de arte <img src='online_log/static/figures/designer.png' height=20>. Estos agentes forman una estructura organizacional multi-agente y están unidos por una misión de "revolucionar el mundo digital a través de la programación." Los agentes dentro de ChatDev **colaboran** participando en seminarios funcionales especializados, incluyendo tareas como diseñar, codificar, probar y documentar.
- El objetivo principal de ChatDev es ofrecer un marco de trabajo **fácil de usar**, **altamente personalizable** y **extensible**, que se basa en modelos de grandems modelos de lenguaje (LLMs, por sus siglas en inglés) y sirve como un escenario ideal para estudiar la inteligencia colectiva.
<p align="center">
<img src='./misc/company.png' width=600>
</p>
## 🎉 Noticias
* **25 de septiembre de 2023: La característica **Git** ya está disponible**, permite al programador <img src='online_log/static/figures/programmer.png' height=20> utilizar GitHub para el control de versiones. Para habilitar esta función, simplemente asigna el valor ``"True"`` igual a ``"git_management"`` en ``ChatChainConfig.json``.
<p align="center">
<img src='./misc/github.png' width=600>
</p>
* 20 de septiembre de 2023: ¡El modo **Interacción Humano-Agente** ya está disponible! Puedes involucrarte con el equipo de ChatDev asumiendo el rol de revisor <img src='online_log/static/figures/reviewer.png' height=20> y haciendo sugerencias al programador <img src='online_log/static/figures/programmer.png' height=20>;
prueba ``python3 run.py --task [description_of_your_idea] --config "Human"``. Consulta la [guía](wiki.md#human-agent-interaction) y el [ejemplo](WareHouse/Gomoku_HumanAgentInteraction_20230920135038).
<p align="center">
<img src='./misc/Human_intro.png' width=600>
</p>
* 1 de septiembre de 2023: ¡El modo **Arte** ya está disponible! Puedes activar al agente de diseño <img src='online_log/static/figures/designer.png' height=20> para generar imágenes utilizadas en el software;
prueba ``python3 run.py --task [description_of_your_idea] --config "Art"``. Consulta la [guía](wiki.md#art) y el [ejemplo](WareHouse/gomokugameArtExample_THUNLP_20230831122822).
* 28 de agosto de 2023: El sistema está disponible al público.
* 17 de agosto de 2023: La versión v1.0.0 estaba lista para ser lanzada.
* 30 de julio de 2023: Los usuarios pueden personalizar los ajustes de ChatChain, Phase, y Role. Además, ahora se soportan tanto el modo Log en línea como el modo de repetición.
* 16 de julio de 2023: Se publicó el [artículo preprint](https://arxiv.org/abs/2307.07924) asociado con este proyecto.
* 30 de junio de 2023: Se lanzó la versión inicial del repositorio de ChatDev.
## ❓ ¿Que puede hcaer ChatDev?
![intro](misc/intro.png)
https://github.com/OpenBMB/ChatDev/assets/11889052/80d01d2f-677b-4399-ad8b-f7af9bb62b72
## ⚡️ Inicio Rápido
Para comenzar, sigue estos pasos:
1. **Clonar el Repositorio de GitHub:** Empieza clonando el repositorio utilizando el comando:
```
git clone https://github.com/OpenBMB/ChatDev.git
```
2. **Configurar el Entorno Python:** Asegúrate de tener un entorno Python versión 3.9 o superior. Puedes crear y
activar este entorno usando los siguientes comandos, reemplazando `ChatDev_conda_env` con el nombre que prefieras para el entorno:
```
conda create -n ChatDev_conda_env python=3.9 -y
conda activate ChatDev_conda_env
```
3. **Instalar Dependencias:** Mueve al directorio `ChatDev` e instala las dependencias necesarias ejecutando:
```
cd ChatDev
pip3 install -r requirements.txt
```
4. **Establecer la Llave de la API de OpenAI:** Exporta tu llave de la API de OpenAI como una variable de entorno. Reemplaza `"your_OpenAI_API_key"` con
tu llave de la API real. Recuerda que esta variable de entorno es específica de la sesión, así que necesitas establecerla de nuevo si
abres una nueva sesión de terminal.
En Unix/Linux:
```
export OPENAI_API_KEY="tu_llave_de_OpenAI_API"
```
En Windows:
```
$env:OPENAI_API_KEY="tu_llave_de_OpenAI_API"
```
5. **Construye Tu Software:** Usa el siguiente comando para iniciar la construcción de tu software,
reemplazando `[description_of_your_idea]` con la descripción de tu idea y `[project_name]` con el nombre deseado para tu proyecto:
En Unix/Linux:
```
python3 run.py --task "[description_de_tu_idea]" --name "[nombre_del_proyecto]"
```
En Windows:
```
python run.py --task "[description_de_tu_idea]" --name "[nombre_del_proyecto]"
```
6. **Ejecuta Tu Software:** Una vez generado, puedes encontrar tu software en el directorio `WareHouse` bajo una carpeta de proyecto específica,
como `nombre_proyecto_OrganizationDefault_timestamp`. Ejecuta tu software usando el siguiente comando dentro de ese directorio:
En Unix/Linux:
```
cd WareHouse/nombre_proyecto_OrganizationDefault_timestamp
python3 main.py
```
En Windows:
```
cd WareHouse/nombre_proyecto_OrganizationDefault_timestamp
python main.py
```
## ✨️ Habilidades Avanzadas
Para obtener información más detallada, por favor refiérese a nuestro [Wiki](wiki.md), donde puede encontrar:
- Una introducción a todos los parámetros de ejecución de comandos.
- Una guía sencilla para configurar una demostración web local, que incluye registros visualizados mejorados, una demostración de repetición y un
sencillo Visualizador de ChatChain.
- Un resumen del marco de trabajo de ChatDev.
- Una introducción exhaustiva a todos los parámetros avanzados en la configuración de ChatChain.
- Guías para personalizar ChatDev, incluyendo:
- ChatChain: Diseña tu propio proceso de desarrollo de software (o cualquier otro proceso), tal
como ``DemandAnalysis -> Coding -> Testing -> Manual``.
- Fase: Diseña tu propia fase dentro de ChatChain, como ``DemandAnalysis``.
- Rol: Definiendo los diversos agentes en tu empresa, como el ``Chief Executive Officer``.
## 🤗 ¡Comparte Tu Software!
**Código**: Estamos entusiasmados con tu interés en participar en nuestro proyecto de código abierto. Si te encuentras con algún
problema, no dudes en reportarlo. ¡Siéntete libre de crear una solicitud de extracción si tienes alguna pregunta o si estás
preparado para compartir tu trabajo con nosotros! Tus contribuciones son muy valoradas. ¡Avísame si hay algo más en lo que
necesitas ayuda!
**Empresa**: Crear tu propia "Empresa ChatDev" personalizada es muy fácil. Esta configuración personalizada involucra tres simples
archivos JSON de configuración. Echa un vistazo al ejemplo proporcionado en el directorio ``CompanyConfig/Default``. Para instrucciones
detalladas sobre la personalización, consulta nuestro [Wiki](wiki.md).
**Software**: Cada vez que desarrolles software usando ChatDev, se generará una carpeta correspondiente que contiene toda la
información esencial. Compartir tu trabajo con nosotros es tan simple como hacer una solicitud de extracción. Aquí hay un ejemplo: ejecuta el
comando ``python3 run.py --task "diseña un juego del a 2048 game" --name "2048" --org "THUNLP" --config "Default"``. Esto creará
un paquete de software y generará una carpeta llamada ``/WareHouse/2048_THUNLP_timestamp``. Dentro, encontrarás:
- Todos los archivos y documentos relacionados con el software del juego 2048
- Archivos de configuración de la empresa responsable de este software, incluyendo los tres archivos JSON de configuración
de ``CompanyConfig/Default``
- Un registro comprensivo que detalla el proceso de construcción del software que se puede utilizar para reproducir (``timestamp.log``)
- El prompt inicial utilizado para crear este software (``2048.prompt``)
**¡Ve el software contribuido por la comunidad [aquí](Contribution.md)!**
## 👨‍💻‍ Software Contributors
<a href="https://github.com/qianc62"><img src="https://avatars.githubusercontent.com/u/48988402?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/thinkwee"><img src="https://avatars.githubusercontent.com/u/11889052?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/NA-Wen"><img src="https://avatars.githubusercontent.com/u/92134380?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/JiahaoLi2003"><img src="https://avatars.githubusercontent.com/u/111221887?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/Alphamasterliu"><img src="https://avatars.githubusercontent.com/u/110011045?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/GeekyWizKid"><img src="https://avatars.githubusercontent.com/u/133981481?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/Munsif-Raza-T"><img src="https://avatars.githubusercontent.com/u/76085202?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/djbritt"><img src="https://avatars.githubusercontent.com/u/28036018?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/Classified3939"><img src="https://avatars.githubusercontent.com/u/102702965?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/chenilim"><img src="https://avatars.githubusercontent.com/u/46905241?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/delconis"><img src="https://avatars.githubusercontent.com/u/5824478?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
<a href="https://github.com/eMcQuill"><img src="https://avatars.githubusercontent.com/u/139025701?v=4" alt="Contributor" style="width:5%; border-radius: 50%;"/></a>
## 🔎 Citación
```
@misc{qian2023communicative,
title={Agentes Comunicativos para Desarrollo de Software},
author={Chen Qian y Xin Cong y Wei Liu y Cheng Yang y Weize Chen y Yusheng Su y Yufan Dang y Jiahao Li y Juyuan Xu y Dahai Li y Zhiyuan Liu y Maosong Sun},
year={2023},
eprint={2307.07924},
archivePrefix={arXiv},
primaryClass={cs.SE}
}
```
## ⚖️ Licencia
- Licencia del Código Fuente: El código fuente de nuestro proyecto está licenciado bajo la Licencia Apache 2.0. Esta licencia permite el uso, modificación y distribución del código, sujeto a ciertas condiciones descritas en la Licencia Apache 2.0.
- Estado de Código Abierto del Proyecto: El proyecto es de código abierto; sin embargo, esta designación está principalmente destinada para propósitos no comerciales. Aunque alentamos la colaboración y las contribuciones de la comunidad para la investigación y aplicaciones no comerciales, es importante notar que cualquier utilización de los componentes del proyecto para propósitos comerciales requiere acuerdos de licencia separados.
- Licencia de Datos: Los datos relacionados utilizados en nuestro proyecto están licenciados bajo CC BY-NC 4.0. Esta licencia permite explícitamente el uso no comercial de los datos. Queremos enfatizar que cualquier modelo entrenado utilizando estos conjuntos de datos debe adherirse estrictamente a la restricción de uso no comercial y debe ser empleado exclusivamente para propósitos de investigación.
## 🌟 Historial de Estrellas
[![Gráfico de Historial de Estrellas](https://api.star-history.com/svg?repos=openbmb/chatdev&type=Date)](https://star-history.com/#openbmb/chatdev&Date)
## 🤝 Agradecimientos
<a href="http://nlp.csai.tsinghua.edu.cn/"><img src="misc/thunlp.png" height=50pt></a>&nbsp;&nbsp;
<a href="https://modelbest.cn/"><img src="misc/modelbest.png" height=50pt></a>&nbsp;&nbsp;
<a href="https://github.com/OpenBMB/AgentVerse/"><img src="misc/agentverse.png" height=50pt></a>&nbsp;&nbsp;
<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>
## 📬 Contacto
Si tienes alguna pregunta, comentarios, o deseas ponerte en contacto, no dudes en enviarnos un correo electrónico a [chatdev.openbmb@outlook.com](mailto:chatdev.openbmb@outlook.com)

View File

@ -5,7 +5,7 @@
</p>
<p align="center">
【English | <a href="README-Chinese.md">Chinese</a> | <a href="README-Japanese.md">Japanese</a> | <a href="README-Korean.md">Korean</a> | <a href="README-Filipino.md">Filipino</a> | <a href="README-French.md">French</a>
【English | <a href="README-Chinese.md">Chinese</a> | <a href="README-Japanese.md">Japanese</a> | <a href="README-Korean.md">Korean</a> | <a href="README-Filipino.md">Filipino</a> | <a href="README-French.md">French</a> | <a href="README-Slovak.md">Slovak</a> | <a href="README-Portuguese.md">Portuguese</a> | <a href="README-Spanish.md">Spanish</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>