> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# التثبيت

> ابدأ مع CrewAI - التثبيت والتهيئة وبناء أول فريق AI

### شاهد: بناء Agents و Flows في CrewAI باستخدام Coding Agent Skills

قم بتثبيت مهارات وكيل البرمجة الخاصة بنا (Claude Code، Codex، ...) لتشغيل وكلاء البرمجة بسرعة مع CrewAI.

يمكنك تثبيتها باستخدام `npx skills add crewaiinc/skills`

[https://www.loom.com/embed/befb9f68b81f42ad8112bfdd95a780af](https://www.loom.com/embed/befb9f68b81f42ad8112bfdd95a780af)

## فيديو تعليمي

شاهد هذا الفيديو التعليمي لعرض تفصيلي لعملية التثبيت:

[CrewAI Installation Guide](https://www.youtube.com/embed/-kSOTtYzgEw)

## دليل نصي

> [!NOTE]
>
> **متطلبات إصدار Python**
>
> يتطلب CrewAI إصدار `Python >=3.10 and <3.14`. إليك كيفية التحقق من إصدارك:
>
> ```bash theme={null}
> python3 --version
> ```
>
> إذا كنت بحاجة لتحديث Python، قم بزيارة [python.org/downloads](https://python.org/downloads)

> [!NOTE]
>
> **متطلبات OpenAI SDK**
>
> يتطلب CrewAI 0.175.0 إصدار `openai >= 1.13.3`. إذا كنت تدير التبعيات بنفسك، تأكد من أن بيئتك تستوفي هذا الشرط لتجنب مشاكل الاستيراد/التشغيل.

يستخدم CrewAI أداة `uv` لإدارة التبعيات والحزم. وهي تبسّط إعداد المشروع وتنفيذه وتوفر تجربة سلسة.

إذا لم تكن قد ثبّتت `uv` بعد، اتبع **الخطوة 1** لإعدادها بسرعة على نظامك، وإلا يمكنك الانتقال إلى **الخطوة 2**.

**1. تثبيت uv**

* **على macOS/Linux:**

  استخدم `curl` لتحميل السكريبت وتنفيذه عبر `sh`:

  ```shell theme={null}
  curl -LsSf https://astral.sh/uv/install.sh | sh
  ```

  إذا لم يكن `curl` متاحًا على نظامك، يمكنك استخدام `wget`:

  ```shell theme={null}
  wget -qO- https://astral.sh/uv/install.sh | sh
  ```

* **على Windows:**

  استخدم `irm` لتحميل السكريبت و`iex` لتنفيذه:

  ```shell theme={null}
  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  ```

  إذا واجهت أي مشاكل، راجع [دليل تثبيت UV](https://docs.astral.sh/uv/getting-started/installation/) لمزيد من المعلومات.

**2. تثبيت CrewAI**

* شغّل الأمر التالي لتثبيت واجهة سطر أوامر `crewai`:

  ```shell theme={null}
  uv tool install crewai
  ```

  > [!WARNING]
  >
  > إذا ظهر تحذير بشأن `PATH`، شغّل هذا الأمر لتحديث الصدفة:
  >
  > ```shell theme={null}
  > uv tool update-shell
  > ```

* للتحقق من تثبيت `crewai`، شغّل:
  ```shell theme={null}
  uv tool list
  ```

* يجب أن ترى شيئًا مثل:
  ```shell theme={null}
  crewai v0.102.0
  - crewai
  ```

* إذا كنت بحاجة لتحديث `crewai`، شغّل:
  ```shell theme={null}
  uv tool install crewai --upgrade
  ```

> [!TIP]
>
> تم التثبيت بنجاح! أنت جاهز لإنشاء أول Crew!

# إنشاء مشروع CrewAI

يقوم `crewai create crew` الآن بإنشاء مشروع crew بأسلوب JSON-first. توضع الـ Agents في `agents/*.jsonc`، وتوضع المهام وإعدادات الـ crew في `crew.jsonc`، ويحمّل `crewai run` هذا التعريف مباشرة.

**1. إنشاء هيكل المشروع**

* شغّل أمر `crewai` عبر CLI:
  ```shell theme={null}
  crewai create crew <your_project_name>
  ```

* سينشئ هذا مشروعًا جديدًا بالهيكل التالي:
  ```
  my_project/
  ├── .gitignore
  ├── .env
  ├── agents/
  │   └── researcher.jsonc
  ├── crew.jsonc
  ├── knowledge/
  ├── pyproject.toml
  ├── README.md
  ├── skills/
  └── tools/
  ```

* إذا احتجت إلى البنية القديمة Python/YAML التي تحتوي على `crew.py` و `config/agents.yaml` و `config/tasks.yaml`، شغّل:
  ```shell theme={null}
  crewai create crew <your_project_name> --classic
  ```

**2. تخصيص مشروعك**

* سيحتوي مشروعك على هذه الملفات الأساسية:
  | الملف | الغرض |
  | - | - |
  | `crew.jsonc` | إعداد الـ crew وترتيب المهام والعملية وقيم الإدخال الافتراضية |
  | `agents/*.jsonc` | تعريف دور كل Agent وهدفه و backstory والـ LLM والأدوات والسلوك |
  | `.env` | تخزين مفاتيح API ومتغيرات البيئة |
  | `tools/` | ملفات Python اختيارية لأدوات `custom:<name>` |
  | `knowledge/` | ملفات معرفة اختيارية للـ Agents |
  | `skills/` | ملفات skills اختيارية تطبق على الـ crew |

* ابدأ بتحرير `crew.jsonc` والملفات داخل `agents/` لتعريف سلوك الـ crew.

* استخدم قيم `{placeholder}` في نصوص الـ Agents والمهام، ثم ضع القيم الافتراضية في `inputs` داخل `crew.jsonc`. عند تشغيل `crewai run` ستطلب CLI أي قيم ناقصة.

* احتفظ بالمعلومات الحساسة مثل مفاتيح API في `.env`.

**3. تشغيل الـ Crew**

* قبل تشغيل الـ Crew، تأكد من تنفيذ:
  ```bash theme={null}
  crewai install
  ```
* إذا كنت بحاجة لتثبيت حزم إضافية، استخدم:
  ```shell theme={null}
  uv add <package-name>
  ```
  > [!NOTE]
  >
  > ChromaDB اعتمادية اختيارية. ثبّته فقط إذا كنت تستخدم مخزن المتجهات ChromaDB أو مزود تضمين يعتمد عليه (Bedrock وCohere وGoogle Generative AI وHugging Face وInstructor وJina وOllama وONNX وOpenCLIP وRoboflow وSentence Transformers وText2Vec): `uv add "crewai[chromadb]"`.
* لتشغيل الـ Crew، نفّذ الأمر التالي في جذر مشروعك:
  ```bash theme={null}
  crewai run
  ```

## خيارات التثبيت للمؤسسات

> [!NOTE]
>
> للفرق والمؤسسات، يوفر CrewAI خيارات نشر مؤسسية تزيل تعقيد الإعداد:
>
> ### CrewAI AMP (SaaS)
>
> * لا يتطلب أي تثبيت - فقط سجّل مجانًا على [app.crewai.com](https://app.crewai.com)
> * تحديثات وصيانة تلقائية
> * بنية تحتية مُدارة وقابلة للتوسع
> * بناء Crews بدون كتابة كود
>
> ### CrewAI Factory (استضافة ذاتية)
>
> * نشر بالحاويات على بنيتك التحتية
>
> * يدعم أي مزود سحابي بما في ذلك النشر المحلي
>
> * تكامل مع أنظمة الأمان الحالية
>
> > [card] [استكشف خيارات المؤسسات](https://share.hsforms.com/1Ooo2UViKQ22UOzdr7i77iwr87kg)
> >
> > تعرّف على عروض CrewAI للمؤسسات وجدول عرضًا توضيحيًا

## الخطوات التالية

> [card] [بدء سريع: Flow + وكيل](https://docs.crewai.com/ar/quickstart.md)
>
> اتبع البداية السريعة لإنشاء Flow وتشغيل طاقم بوكيل واحد وإنتاج تقرير.

> [card] [انضم إلى المجتمع](https://community.crewai.com)
>
> تواصل مع مطورين آخرين واحصل على المساعدة وشارك تجاربك مع CrewAI.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.