> ## 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
  > ```

  > [!WARNING]
  >
  > إذا واجهت خطأ بناء `chroma-hnswlib==0.7.6` (`fatal error C1083: Cannot open include file: 'float.h'`) على Windows، ثبّت [Visual Studio Build Tools](https://visualstudio.microsoft.com/downloads/) مع خيار *Desktop development with C++*.

* للتحقق من تثبيت `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>
  ```
* لتشغيل الـ Crew، نفّذ الأمر التالي في جذر مشروعك:
  ```bash theme={null}
  crewai run
  ```

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

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

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

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

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


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