|
| 1 | +# الیزا 🤖 |
| 2 | + |
| 3 | +<div align="center"> |
| 4 | + <img src="./docs/static/img/eliza_banner.jpg" alt="الیزا بنر" width="100%" /> |
| 5 | +</div> |
| 6 | + |
| 7 | +<div align="center"> |
| 8 | + |
| 9 | +📖 [مستندات](https://elizaos.github.io/eliza/) | 🎯 [نمونهها](https://github.com/thejoven/awesome-eliza) |
| 10 | + |
| 11 | +</div> |
| 12 | + |
| 13 | +## 🚩 معرفی کلی |
| 14 | + |
| 15 | +<div align="center"> |
| 16 | + <img src="./docs/static/img/eliza_diagram.png" alt="نمودار الیزا" width="100%" /> |
| 17 | +</div> |
| 18 | + |
| 19 | +## ✨ ویژگیها |
| 20 | + |
| 21 | +- 🛠️ پشتیبانی کامل از اتصال به دیسکورد، توییتر و تلگرام |
| 22 | +- 🔗 سازگاری با همه مدلها (Llama، Grok، OpenAI، Anthropic و غیره) |
| 23 | +- 👥 پشتیبانی از چند عامل و چند اتاق |
| 24 | +- 📚 مدیریت و تعامل آسان با اسناد شما |
| 25 | +- 💾 حافظه و ذخیرهسازی اسناد قابل بازیابی |
| 26 | +- 🚀 بسیار قابل گسترش - امکان ایجاد اکشنها و کلاینتهای سفارشی |
| 27 | +- ☁️ پشتیبانی از مدلهای مختلف (local Llama, OpenAI، Anthropic, etc. ) |
| 28 | +- 📦 به سادگی کار میکند! |
| 29 | + |
| 30 | +## آموزشهای ویدیویی |
| 31 | + |
| 32 | +[AI Agent Dev School](https://www.youtube.com/watch?v=ArptLpQiKfI&list=PLx5pnFXdPTRzWla0RaOxALTSTnVq53fKL) |
| 33 | + |
| 34 | +## 🎯 موارد استفاده |
| 35 | + |
| 36 | +- 🤖 چتباتها |
| 37 | +- 🕵️ عوامل خودکار |
| 38 | +- 📈 مدیریت فرآیندهای کسبوکار |
| 39 | +- 🎮 کاراکترهای بازیهای ویدیویی |
| 40 | +- 🧠 معاملات تجاری |
| 41 | + |
| 42 | +## 🚀 شروع سریع |
| 43 | + |
| 44 | +### پیشنیازها |
| 45 | + |
| 46 | +- [Python 2.7+](https://www.python.org/downloads/) |
| 47 | +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) |
| 48 | +- [pnpm](https://pnpm.io/installation) |
| 49 | + |
| 50 | +> **توجه برای کاربران ویندوز:** [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install-manual) لازم است. |
| 51 | +
|
| 52 | +### استفاده از پروژه آغازین (توصیهشده) |
| 53 | + |
| 54 | +```bash |
| 55 | +git clone https://github.com/elizaos/eliza-starter.git |
| 56 | +cd eliza-starter |
| 57 | +cp .env.example .env |
| 58 | +pnpm i && pnpm build && pnpm start |
| 59 | +``` |
| 60 | + |
| 61 | +پس از اجرای عامل، باید پیامی برای اجرای "pnpm start:client" دریافت کنید. |
| 62 | +یک ترمینال جدید باز کنید و به همان دایرکتوری رفته و دستور زیر را اجرا کنید تا با عامل خود گفتگو کنید: |
| 63 | + |
| 64 | +```bash |
| 65 | +pnpm start:client |
| 66 | +``` |
| 67 | + |
| 68 | +سپس [مستندات](https://elizaos.github.io/eliza/) را مطالعه کنید تا بیاموزید چگونه الیزا را سفارشی کنید. |
| 69 | + |
| 70 | +### اجرای دستی الیزا (فقط در صورتی که تخصص دارید توصیه میشود) |
| 71 | + |
| 72 | +```bash |
| 73 | +# کلون کردن مخزن |
| 74 | +git clone https://github.com/elizaos/eliza.git |
| 75 | + |
| 76 | +# انتخاب آخرین نسخه پایدار |
| 77 | +# این پروژه سریع بهروزرسانی میشود، پیشنهاد میکنیم آخرین نسخه پایدار را انتخاب کنید |
| 78 | +git checkout $(git describe --tags --abbrev=0) |
| 79 | +# اگر دستور بالا آخرین نسخه را انتخاب نکرد، این دستور را امتحان کنید: |
| 80 | +# git checkout $(git describe --tags `git rev-list --tags --max-count=1`) |
| 81 | +``` |
| 82 | + |
| 83 | +### اجرای الیزا با Gitpod |
| 84 | + |
| 85 | +[](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main) |
| 86 | + |
| 87 | +### ویرایش فایل .env |
| 88 | + |
| 89 | +یک کپی از .env.example بگیرید و مقادیر مناسب را وارد کنید: |
| 90 | + |
| 91 | +``` |
| 92 | +cp .env.example .env |
| 93 | +``` |
| 94 | + |
| 95 | +توجه: فایل .env اختیاری است. اگر قصد دارید چندین عامل متمایز اجرا کنید، میتوانید اطلاعات محرمانه را از طریق فایل JSON شخصیت انتقال دهید. |
| 96 | + |
| 97 | +### شروع خودکار الیزا |
| 98 | + |
| 99 | +این دستور همه مراحل راهاندازی پروژه را انجام داده و بات را با شخصیت پیشفرض اجرا میکند: |
| 100 | + |
| 101 | +```bash |
| 102 | +sh scripts/start.sh |
| 103 | +``` |
| 104 | + |
| 105 | +### ویرایش فایل شخصیت |
| 106 | + |
| 107 | +1. فایل `packages/core/src/defaultCharacter.ts` را باز کنید تا شخصیت پیشفرض را تغییر دهید. تغییرات لازم را انجام دهید. |
| 108 | +2. برای بارگذاری شخصیتهای سفارشی: |
| 109 | + - از دستور `pnpm start --characters="path/to/your/character.json"` استفاده کنید. |
| 110 | + - چندین فایل شخصیت میتوانند همزمان بارگذاری شوند. |
| 111 | +3. اتصال به توییتر (X): |
| 112 | + - مقدار `"clients": []` را به `"clients": ["twitter"]` در فایل شخصیت تغییر دهید. |
| 113 | + |
| 114 | +### اجرای دستی الیزا |
| 115 | + |
| 116 | +```bash |
| 117 | +pnpm i |
| 118 | +pnpm build |
| 119 | +pnpm start |
| 120 | + |
| 121 | +# اگر پروژه به دلیل تغییرات سریع نیاز به پاکسازی داشت، دستور زیر را اجرا کنید: |
| 122 | +pnpm clean |
| 123 | +``` |
| 124 | + |
| 125 | +#### نیازمندیهای اضافی |
| 126 | + |
| 127 | +ممکن است نیاز به نصب Sharp باشد. اگر هنگام راهاندازی خطایی دیدید، دستور زیر را اجرا کنید: |
| 128 | + |
| 129 | +``` |
| 130 | +pnpm install --include=optional sharp |
| 131 | +``` |
| 132 | + |
| 133 | +### انجمن و تماس |
| 134 | + |
| 135 | +- [مشکلات در GitHub](https://github.com/elizaos/eliza/issues). بهترین گزینه برای گزارش باگها و پیشنهاد ویژگیها. |
| 136 | +- [Discord](https://discord.gg/ai16z). بهترین گزینه برای به اشتراک گذاشتن برنامههای شما و ارتباط با جامعه. |
| 137 | + |
| 138 | +## مشارکتکنندگان |
| 139 | + |
| 140 | +<a href="https://github.com/elizaos/eliza/graphs/contributors"> |
| 141 | + <img src="https://contrib.rocks/image?repo=elizaos/eliza" /> |
| 142 | +</a> |
| 143 | + |
| 144 | +## تاریخچه ستارهها |
| 145 | + |
| 146 | +[](https://star-history.com/#elizaos/eliza&Date) |
| 147 | + |
0 commit comments