Add i18n support for multilingual documentation in mkdocs.yml

docs/fa/concepts/why-multi-agent.md

@@ -0,0 +1,55 @@
+# چرا سیستم‌های چند عامله؟
+
+سیستم‌های چند عامله یک رویکرد قدرتمند برای حل مسائل پیچیده با استفاده از همکاری بین عامل‌های هوش مصنوعی است. در این صفحه، مزایای اصلی و دلایل استفاده از این سیستم‌ها را بررسی می‌کنیم.
+
+## مزایای کلیدی
+
+### ۱. تقسیم وظایف پیچیده
+سیستم‌های چند عامله می‌توانند مسائل پیچیده را به زیر وظایف کوچکتر و قابل مدیریت تقسیم کنند. هر عامل می‌تواند روی یک جنبه خاص از مسئله تمرکز کند و با تخصص خود به حل آن بپردازد.
+
+### ۲. افزایش کارایی
+با تقسیم کار بین چندین عامل، می‌توان وظایف را به صورت موازی انجام داد و سرعت پردازش را افزایش داد. این موضوع به ویژه در پروژه‌های بزرگ و پیچیده اهمیت دارد.
+
+### ۳. انعطاف‌پذیری و مقیاس‌پذیری
+سیستم چند عامله به راحتی قابل گسترش است. می‌توانید عامل‌های جدید را اضافه کنید یا عامل‌های موجود را تغییر دهید بدون اینکه نیاز به تغییر کل سیستم باشد.
+
+## نمونه کاربردی
+
+```python
+from swarms import Agent, Swarm
+
+# تعریف عامل‌ها با تخصص‌های مختلف
+researcher = Agent(name="researcher", task="جمع‌آوری اطلاعات")
+analyst = Agent(name="analyst", task="تحلیل داده")
+writer = Agent(name="writer", task="نگارش گزارش")
+
+# ایجاد گروه با عامل‌های متخصص
+research_team = Swarm(
+    agents=[researcher, analyst, writer],
+    workflow="sequential"
+)
+
+# اجرای پروژه تحقیقاتی
+result = research_team.run("تحقیق در مورد روند‌های بازار و تهیه گزارش")
+```
+
+## مقایسه با سیستم‌های تک عامله
+
+| ویژگی | سیستم تک عامله | سیستم چند عامله |
+|-------|----------------|-----------------|
+| پیچیدگی | محدود به توانایی یک عامل | توزیع پیچیدگی بین عامل‌ها |
+| مقیاس‌پذیری | محدود | بالا |
+| انعطاف‌پذیری | کم | زیاد |
+| سرعت پردازش | متوسط | بالا (پردازش موازی) |
+| مدیریت خطا | نقطه شکست واحد | مقاوم در برابر خطا |
+
+## نتیجه‌گیری
+
+سیستم‌های چند عامله یک راه‌حل قدرتمند برای پروژه‌های پیچیده هستند. با تقسیم وظایف بین عامل‌های متخصص، می‌توانید:
+
+- کارایی را افزایش دهید
+- انعطاف‌پذیری بیشتری داشته باشید
+- مقیاس‌پذیری را بهبود بخشید
+- مدیریت خطا را بهتر کنید
+
+برای اطلاعات بیشتر در مورد پیاده‌سازی، به بخش [راهنمای پیاده‌سازی](../best-practices/implementation.md) مراجعه کنید. 

docs/fa/index.md

@@ -0,0 +1,56 @@
+# سیستم‌های چند عامله LLM
+
+به راهنمای جامع سیستم‌های چند عامله خوش آمدید! این مستندات به شما کمک می‌کند تا سیستم‌های چند عامله قدرتمند و کارآمد را با استفاده از مدل‌های زبانی بزرگ (LLMs) ایجاد و مدیریت کنید.
+
+## مزایای اصلی
+
+* 🤝 **همکاری هوشمند** - عامل‌های متعدد که برای حل مسائل پیچیده با هم همکاری می‌کنند
+* 🎯 **تخصص متمرکز** - هر عامل روی یک وظیفه خاص تمرکز می‌کند
+* 🔄 **انعطاف‌پذیری** - سیستم قابل تطبیق با نیازهای در حال تغییر
+* 📈 **مقیاس‌پذیری** - افزودن عامل‌های جدید برای گسترش قابلیت‌ها
+
+## شروع سریع
+
+برای شروع کار با سیستم چند عامله، این مراحل را دنبال کنید:
+
+```python
+from swarms import Agent, Swarm
+
+# ایجاد عامل‌ها
+agent1 = Agent(name="agent1", task="تحلیل داده")
+agent2 = Agent(name="agent2", task="تولید گزارش")
+
+# ایجاد گروه
+swarm = Swarm(agents=[agent1, agent2])
+
+# اجرای وظیفه
+result = swarm.run("تحلیل داده‌های فروش و تولید گزارش")
+```
+
+## ساختار پروژه
+
+- `swarms/` - کتابخانه اصلی
+- `examples/` - نمونه‌های کاربردی
+- `docs/` - مستندات
+- `tests/` - تست‌های واحد
+
+## نصب
+
+```bash
+pip install swarms
+```
+
+## مشارکت
+
+ما از مشارکت‌های جامعه استقبال می‌کنیم! لطفاً [راهنمای مشارکت](contributing.md) ما را مطالعه کنید.
+
+## پشتیبانی
+
+برای سوالات و پشتیبانی:
+- 📖 [مستندات](https://swarms.readthedocs.io)
+- 💬 [انجمن](https://github.com/swarms/discussions)
+- 🐛 [گزارش مشکلات](https://github.com/swarms/issues)
+
+## مجوز
+
+این پروژه تحت مجوز MIT منتشر شده است. برای جزئیات بیشتر [فایل مجوز](LICENSE) را ببینید. 

mkdocs.yml

@@ -59,6 +59,26 @@ plugins:
   - search
   - minify:
       minify_html: true
+  - i18n:
+      default_language: en
+      languages:
+        en: English
+        fa: فارسی
+      nav_translations:
+        fa:
+          Home: خانه
+          "Core Concepts": مفاهیم اصلی
+          "Why Multi-Agent Systems?": چرا سیستم‌های چند عامله؟
+          "Limitations of Individual Agents": محدودیت‌های عامل‌های انفرادی
+          "Multi-Agent Architecture": معماری چند عامله
+          "Best Practices": بهترین شیوه‌ها
+          "Implementation Guide": راهنمای پیاده‌سازی
+          "Communication Protocols": پروتکل‌های ارتباطی
+          "Error Handling": مدیریت خطا
+          "Performance Optimization": بهینه‌سازی عملکرد
+          "FAQ": سوالات متداول
+          "Tips & Troubleshooting": نکات و عیب‌یابی
+          "Glossary": واژه‌نامه
 
 extra:
   social:

requirements.txt

@@ -23,3 +23,4 @@ networkx
 aiofiles
 httpx
 # vllm>=0.2.0
+mkdocs-i18n>=0.4.4