# Communicative Agents for Software Development

【📚 Wiki | 🚀 Visualizer | 👥 Community Built Software | 🔧 Customization | 👾 Discord】

## 📖 Overview - **ChatDev** ایک **virtual software company** کے طور پر کھڑی ہے جو مختلف **intelligent agents** کے ذریعے کام کرتی ہے جن کے مختلف کردار ہیں، بشمول چیف ایگزیکٹو آفیسر

، چیف پراڈکٹ آفیسر

، چیف ٹیکنالوجی آفیسر

، پروگرامر

، ریویور

، ٹیسٹر

، آرٹ ڈیزائنر

۔ یہ ایجنٹس ایک کثیر ایجنسی تنظیمی ڈھانچہ بناتے ہیں اور ایک مشن کے ذریعے متحد ہوتے ہیں کہ "پروگرامنگ کے ذریعے ڈیجیٹل دنیا میں انقلاب لانا"۔ ChatDev میں ایجنٹس مخصوص فنکشنل سیمینارز میں حصہ لے کر **تعاون** کرتے ہیں، جن میں ڈیزائننگ، کوڈنگ، ٹیسٹنگ، اور دستاویزات جیسی سرگرمیاں شامل ہیں۔ - ChatDev کا بنیادی مقصد ایک **easy-to-use**, **highly customizable** اور **extendable** فریم ورک پیش کرنا ہے، جو بڑے زبان کے ماڈلز (LLMs) پر مبنی ہے اور اجتماعی ذہانت کے مطالعہ کے لیے ایک مثالی منظر نامہ فراہم کرتا ہے۔

## 🎉 News * **25 جون 2024: 🎉LLM پر مبنی کثیر ایجنسی تعاون🤖🤖 اور متعلقہ شعبوں میں ترقی کو فروغ دینے کے لیے، ChatDev ٹیم نے ایک [اوپن سورس](https://github.com/OpenBMB/ChatDev/tree/main/MultiAgentEbook) انٹرایکٹو ای بک📚 فارمیٹ میں ایک مجموعہ تیار کیا ہے۔ اب آپ [Ebook ویب سائٹ](https://thinkwee.top/multiagent_ebook) پر تازہ ترین پیشرفتوں کا جائزہ لے سکتے ہیں اور [پیپر لسٹ](https://github.com/OpenBMB/ChatDev/blob/main/MultiAgentEbook/papers.csv) ڈاؤن لوڈ کر سکتے ہیں۔**

* 12 جون 2024: ہم نے ملٹی ایجنٹ کولیبریشن نیٹ ورکس (MacNet) 🎉 متعارف کرائے ہیں، جو لسانی تعاملات کے ذریعے ایجنٹس کے درمیان موثر کام پر مبنی تعاون کو آسان بنانے کے لیے ڈائریکٹڈ ایسائیکلیک گراف استعمال کرتے ہیں۔ 🤖🤖 MacNet مختلف ٹاپولوجیز اور ایک ہزار سے زیادہ ایجنٹس کے درمیان تعاون کی حمایت کرتا ہے بغیر سیاق و سباق کی حدود سے تجاوز کیے۔ زیادہ ورسٹائل اور قابل توسیع، MacNet کو ChatDev کی چین کی شکل کی ٹاپولوجی کے ایک زیادہ جدید ورژن کے طور پر سمجھا جا سکتا ہے۔ ہمارا پری پرنٹ پیپر [https://arxiv.org/abs/2406.07155](https://arxiv.org/abs/2406.07155) پر دستیاب ہے۔ یہ تکنیک جلد ہی اس ریپوزٹری میں شامل کر دی جائے گی، جو سافٹ ویئر ڈویلپمنٹ سے آگے (مثلاً منطقی استدلال، ڈیٹا کا تجزیہ، کہانی کی تخلیق، وغیرہ) متنوع تنظیمی ڈھانچے کی حمایت اور بھرپور حل پیش کرے گی۔

پرانا نیوز

* 7 مئی 2024 کو، ہم نے "آئیٹریٹو ایکسپیرینس ریفائنمنٹ" (IER) متعارف کروایا، جو ایک نیا طریقہ ہے جس میں انسٹرکٹر اور اسسٹنٹ ایجنٹس شارٹ کٹ پر مبنی تجربات کو بہتر بناتے ہیں تاکہ نئے کاموں کے لیے مؤثر طریقے سے اپنایا جا سکے۔ یہ طریقہ تجربات کے حصول، استعمال، پھیلاؤ، اور ختم کرنے کے مراحل پر مبنی ہے۔ ہمارا پیشگی پرنٹ پیپر https://arxiv.org/abs/2405.04219 پر دستیاب ہے، اور یہ تکنیک جلد ہی ChatDev میں شامل کی جائے گی۔

* 25 جنوری 2024: ہم نے ChatDev میں تجرباتی کو لرننگ ماڈیول کو شامل کیا ہے۔ براہ کرم [تجرباتی کو لرننگ گائیڈ](wiki.md#co-tracking) دیکھیں۔ * 28 دسمبر 2023: ہم نے تجرباتی کو لرننگ کا نیا طریقہ متعارف کروایا ہے جس میں انسٹرکٹر اور اسسٹنٹ ایجنٹس شارٹ کٹ پر مبنی تجربات کو جمع کرتے ہیں تاکہ نئے کاموں کو مؤثر طریقے سے حل کیا جا سکے، جس سے تکراری غلطیوں کو کم کیا جا سکتا ہے اور کارکردگی میں اضافہ ہوتا ہے۔ مزید تفصیلات کے لیے ہمارا پیشگی پرنٹ پیپر https://arxiv.org/abs/2312.17025 پر دیکھیں اور یہ تکنیک جلد ہی ChatDev میں شامل کی جائے گی۔

* 15 نومبر 2023: ہم نے ChatDev کو ایک SaaS پلیٹ فارم کے طور پر لانچ کیا، جو سافٹ ویئر ڈیولپرز اور تخلیقی کاروباری افراد کو بہت کم قیمت اور رکاوٹ کے ساتھ سافٹ ویئر بنانے کے قابل بناتا ہے۔ اسے آزمانے کے لیے https://chatdev.modelbest.cn/ پر جائیں۔

* 2 نومبر 2023: ChatDev میں اب نیا فیچر شامل ہے: انکریمنٹل ڈیولپمنٹ، جو ایجنٹس کو موجودہ کوڈز پر مزید ترقی کرنے کی اجازت دیتا ہے۔ اسے شروع کرنے کے لیے `--config "incremental" --path "[source_code_directory_path]"` استعمال کریں۔

* 26 اکتوبر 2023: ChatDev میں اب محفوظ عمل درآمد کے لیے Docker کی سپورٹ شامل ہے (شکریہ [ManindraDeMel](https://github.com/ManindraDeMel) کے تعاون کا)۔ براہ کرم [Docker شروع کرنے کی گائیڈ](wiki.md#docker-start) دیکھیں۔

* 25 ستمبر 2023: **Git** موڈ اب دستیاب ہے، جس سے پروگرامر

Git کو ورژن کنٹرول کے لیے استعمال کرنے کے قابل بناتا ہے۔ اس فیچر کو فعال کرنے کے لیے، `ChatChainConfig.json` میں ``"git_management"`` کو ``"True"`` پر سیٹ کریں۔ [گائیڈ](wiki.md#git-mode) دیکھیں۔

- 20 ستمبر 2023: **انسان-ایجنٹ تعامل** موڈ اب دستیاب ہے! آپ ChatDev ٹیم کے ساتھ شامل ہو سکتے ہیں اور ریویور

کا کردار ادا کر کے پروگرامر

کو تجاویز دے سکتے ہیں؛ ``python3 run.py --task [description_of_your_idea] --config "Human"`` استعمال کریں۔ [گائیڈ](wiki.md#human-agent-interaction) اور [مثال](WareHouse/Gomoku_HumanAgentInteraction_20230920135038) دیکھیں۔

- 1 ستمبر 2023: **آرٹ** موڈ اب دستیاب ہے! آپ ڈیزائنر ایجنٹ

کو سافٹ ویئر میں استعمال کے لیے تصاویر پیدا کرنے کے لیے فعال کر سکتے ہیں؛ ``python3 run.py --task [description_of_your_idea] --config "Art"`` استعمال کریں۔ [گائیڈ](wiki.md#art) اور [مثال](WareHouse/gomokugameArtExample_THUNLP_20230831122822) دیکھیں۔ - 28 اگست 2023: نظام عوامی طور پر دستیاب ہے۔ - 17 اگست 2023: ورژن v1.0.0 ریلیز کے لیے تیار تھا۔ - 30 جولائی 2023: صارفین ChatChain، فیز، اور رول سیٹنگز کو اپنی مرضی کے مطابق بنا سکتے ہیں۔ اس کے علاوہ، دونوں آن لائن لاگ موڈ اور ریپلے موڈ اب سپورٹڈ ہیں۔ - 16 جولائی 2023: اس پروجیکٹ سے منسلک [پیشگی پرنٹ پیپر](https://arxiv.org/abs/2307.07924) شائع ہوا۔ - 30 جون 2023: ChatDev ریپوزٹری کا ابتدائی ورژن جاری ہوا۔

## ❓ What Can ChatDev Do? ![intro](misc/intro.png) ## ⚡️ Quickstart ### 💻️ Quickstart with Web ویژولائزیشن اور کنفیگریشن کے لیے ویب پیج تک رسائی کریں: https://chatdev.modelbest.cn/ ### 🖥️ Quickstart with terminal شروع کرنے کے لیے، یہ اقدامات کریں: 1. **Clone the GitHub Repository:** ریپوزٹری کو کلون کرنے کے لیے درج ذیل کمانڈ استعمال کریں: ``` git clone https://github.com/OpenBMB/ChatDev.git ``` 2. **Set Up Python Environment:** یقینی بنائیں کہ آپ کے پاس Python کا ورژن 3.9 یا اس سے اوپر کا ماحول موجود ہے۔ آپ درج ذیل کمانڈز استعمال کر کے اس ماحول کو بنا سکتے ہیں اور فعال کر سکتے ہیں، `ChatDev_conda_env` کو اپنے پسندیدہ ماحول کے نام سے تبدیل کریں: ``` conda create -n ChatDev_conda_env python=3.9 -y conda activate ChatDev_conda_env ``` 3. **Install Dependencies:** `ChatDev` ڈائریکٹری میں جائیں اور ضروری ڈپنڈینسز کو انسٹال کرنے کے لیے درج ذیل کمانڈ استعمال کریں: ``` cd ChatDev pip3 install -r requirements.txt ``` 4. **Set OpenAI API Key:** اپنے OpenAI API کلید کو ایک ماحول ویریبل کے طور پر ایکسپورٹ کریں۔ `"your_OpenAI_API_key"` کو اپنی اصل API کلید سے تبدیل کریں۔ یاد رکھیں کہ یہ ماحول ویریبل سیشن مخصوص ہے، اس لیے اگر آپ ایک نیا ٹرمینل سیشن کھولتے ہیں تو آپ کو دوبارہ اسے سیٹ کرنا ہوگا۔ Unix/Linux پر: ``` export OPENAI_API_KEY="your_OpenAI_API_key" ``` Windows پر: ``` $env:OPENAI_API_KEY="your_OpenAI_API_key" ``` 5. **Build Your Software:** اپنے سافٹ ویئر کو بنانے کے لیے درج ذیل کمانڈ استعمال کریں، `[description_of_your_idea]` کو اپنے آئیڈیا کی وضاحت سے اور `[project_name]` کو اپنے مطلوبہ پروجیکٹ کے نام سے تبدیل کریں: Unix/Linux پر: ``` python3 run.py --task "[description_of_your_idea]" --name "[project_name]" ``` Windows پر: ``` python run.py --task "[description_of_your_idea]" --name "[project_name]" ``` 6. **Run Your Software:** ایک بار جب سافٹ ویئر بن جائے، آپ اپنا سافٹ ویئر `WareHouse` ڈائریکٹری کے مخصوص پروجیکٹ فولڈر میں پا سکتے ہیں، جیسے `project_name_DefaultOrganization_timestamp`۔ اس ڈائریکٹری میں درج ذیل کمانڈ استعمال کر کے اپنا سافٹ ویئر چلائیں: Unix/Linux پر: ``` cd WareHouse/project_name_Default ``` On Windows: ``` cd WareHouse/project_name_DefaultOrganization_timestamp python main.py ``` ### 🐳 Quickstart with Docker - ہم [ManindraDeMel](https://github.com/ManindraDeMel) کا شکریہ ادا کرتے ہیں جنہوں نے Docker کی سپورٹ فراہم کی۔ براہ کرم [Docker شروع کرنے کی گائیڈ](wiki.md#docker-start) دیکھیں۔ ## ✨️ Advanced Skills مزید تفصیلات کے لیے، براہ کرم ہماری [Wiki](wiki.md) دیکھیں، جہاں آپ کو درج ذیل معلومات مل سکتی ہیں: - تمام کمانڈ رن پیرامیٹرز کا تعارف۔ - مقامی ویب ویزولائزر ڈیمو سیٹ اپ کرنے کے لیے ایک سیدھی سادی گائیڈ، جو حقیقی وقت کے لاگز، دوبارہ چلائے گئے لاگز، اور ChatChain کو ویزولائز کر سکتی ہے۔ - ChatDev فریم ورک کا ایک جائزہ۔ - ChatChain کنفیگریشن میں تمام ایڈوانس پیرامیٹرز کا ایک جامع تعارف۔ - ChatDev کو حسب ضرورت بنانے کے لیے گائیڈز، بشمول: - ChatChain: اپنا سافٹ ویئر ڈویلپمنٹ کا عمل (یا کوئی اور عمل) ڈیزائن کریں، جیسے ``DemandAnalysis -> Coding -> Testing -> Manual``۔ - Phase: ChatChain کے اندر اپنے مرحلے کو ڈیزائن کریں، جیسے ``DemandAnalysis``۔ - Role: آپ کی کمپنی کے مختلف ایجنٹس کو ڈیفائن کرنا، جیسے ``Chief Executive Officer``۔ ## 🤗 Share Your Software **Code**: ہم اپنے اوپن سورس پروجیکٹ میں آپ کی دلچسپی کا خیرمقدم کرتے ہیں۔ اگر آپ کو کسی قسم کی مشکلات کا سامنا ہوتا ہے تو انہیں رپورٹ کرنے میں بالکل نہ ہچکچائیں۔ اگر آپ کے پاس کوئی سوالات ہیں یا آپ اپنا کام ہمارے ساتھ شیئر کرنے کے لیے تیار ہیں تو بلا جھجھک پل ریکویسٹ بنائیں! آپ کی شراکت کو بہت قدر کی نگاہ سے دیکھا جائے گا۔ اگر آپ کو کسی اور چیز میں مدد کی ضرورت ہے تو براہ کرم بتائیں! **Company**: اپنی حسب ضرورت "ChatDev کمپنی" بنانا بہت آسان ہے۔ یہ ذاتی سیٹ اپ تین سادہ کنفیگریشن JSON فائلوں پر مشتمل ہوتا ہے۔ ``CompanyConfig/Default`` ڈائریکٹری میں فراہم کردہ مثال دیکھیں۔ حسب ضرورت بنانے کی تفصیلی ہدایات کے لیے ہماری [Wiki](wiki.md) دیکھیں۔ **Software**: جب بھی آپ ChatDev استعمال کرتے ہوئے سافٹ ویئر تیار کرتے ہیں، تو اس کے مطابق ایک فولڈر بنایا جاتا ہے جس میں تمام ضروری معلومات شامل ہوتی ہیں۔ اپنا کام ہمارے ساتھ شیئر کرنا اتنا ہی آسان ہے جتنا کہ پل ریکویسٹ بنانا۔ مثال کے طور پر، یہ کمانڈ چلائیں ``python3 run.py --task "design a 2048 game" --name "2048" --org "THUNLP" --config "Default"``۔ یہ ایک سافٹ ویئر پیکج تیار کرے گا اور ``/WareHouse/2048_THUNLP_timestamp`` نامی فولڈر بنائے گا۔ اس کے اندر آپ کو درج ذیل چیزیں ملیں گی: - 2048 گیم سافٹ ویئر سے متعلق تمام فائلیں اور دستاویزات - اس سافٹ ویئر کی ذمہ دار کمپنی کی کنفیگریشن فائلیں، جن میں ``CompanyConfig/Default`` کی تین JSON کنفیگریشن فائلیں شامل ہیں۔ - سافٹ ویئر کے بنانے کے عمل کی ایک جامع لاگ جو دوبارہ چلانے کے لیے استعمال کی جا سکتی ہے (``timestamp.log``) - اس سافٹ ویئر کو بنانے کے لیے استعمال کیا گیا ابتدائی پرامپٹ (``2048.prompt``) **See community contributed software [here](Contribution.md)!** ## 👨‍💻‍ Contributors

Made with [contrib.rocks](https://contrib.rocks). ## 🔎 Citation ``` @article{chatdev, title = {ChatDev: Communicative Agents for Software Development}, author = {Chen Qian and Wei Liu and Hongzhang Liu and Nuo Chen and Yufan Dang and Jiahao Li and Cheng Yang and Weize Chen and Yusheng Su and Xin Cong and Juyuan Xu and Dahai Li and Zhiyuan Liu and Maosong Sun}, journal = {arXiv preprint arXiv:2307.07924}, url = {https://arxiv.org/abs/2307.07924}, year = {2023} } ``` ## ⚖️ License - **Source Code Licensing**: ہمارے پروجیکٹ کا سورس کوڈ Apache 2.0 لائسنس کے تحت لائسنس یافتہ ہے۔ اس لائسنس کے تحت کوڈ کے استعمال، ترمیم، اور تقسیم کی اجازت ہے، بشرطیکہ Apache 2.0 لائسنس میں بیان کردہ شرائط پر عمل کیا جائے۔ - **Data Licensing**: ہمارے پروجیکٹ میں استعمال ہونے والا متعلقہ ڈیٹا CC BY-NC 4.0 لائسنس کے تحت لائسنس یافتہ ہے۔ یہ لائسنس ڈیٹا کے غیر تجارتی استعمال کی صریح اجازت دیتا ہے۔ ہم اس بات پر زور دینا چاہیں گے کہ ان ڈیٹا سیٹس کا استعمال کرتے ہوئے تربیت یافتہ کسی بھی ماڈل کو سختی سے غیر تجارتی استعمال کی پابندی پر عمل کرنا چاہیے اور اسے صرف تحقیقی مقاصد کے لیے استعمال کیا جانا چاہیے۔ ## 🤝 Acknowledgments

## 📬 Contact اگر آپ کے پاس کوئی سوالات، تجاویز ہیں یا آپ ہم سے رابطہ کرنا چاہتے ہیں، تو براہ کرم بلا جھجھک ہمیں ای میل کے ذریعے [qianc62@gmail.com](mailto:qianc62@gmail.com) پر رابطہ کریں۔