> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 1. تنزيل Toolkit

> ثبّت GNU sed واستنسخ Ayakaleaf Toolkit على جهاز Mac.

**1. تحقّق من Git وHomebrew**

```bash theme={null}
git --version
brew --version
```

إذا طلب منك macOS تثبيت Command Line Tools عند تشغيل Git، فثبّتها أولًا. إذا لم يكن Homebrew مثبّتًا، فثبّته باتباع [التعليمات الرسمية](https://brew.sh/).

**2. ضع GNU sed في PATH**

تستخدم سكربتات Toolkit خيارات GNU sed التي يرفضها BSD sed المدمج في macOS. ثبّت [GNU sed](https://formulae.brew.sh/formula/gnu-sed) وضعه أولًا في `PATH` في هذه الطرفية:

```bash theme={null}
brew install gnu-sed
export PATH="$(brew --prefix gnu-sed)/libexec/gnubin:$PATH"
sed --version
```

يجب أن يطبع الأمر الأخير **GNU sed**.

لا يكفي اسم مستعار مثل `alias sed=gsed`: إذ يشغّل Toolkit سكربتات Bash، وهي لا ترى الأسماء المستعارة الخاصة بصدفتك التفاعلية. ولا تحتاج إلى استبدال `/usr/bin/sed`.

شغّل سطر `export PATH=...` مجددًا في كل طرفية جديدة تستخدمها مع Toolkit، أو أضفه إلى ملف بدء تشغيل الصدفة بعد التهيئة الخاصة بـ Homebrew.

**3. استنسخ مستودع Ayakaleaf Toolkit**

اختر مجلدًا دائمًا. تجنّب `/tmp` ومحركات الأقراص القابلة للإزالة والمجلدات المتزامنة مع السحابة مثل iCloud Drive لقاعدة البيانات الحية وبيانات المشاريع. يستخدم هذا الدليل `~/ayakaleaf-toolkit`:

```bash theme={null}
git clone https://github.com/ayaka-notes/toolkit.git "$HOME/ayakaleaf-toolkit"
cd "$HOME/ayakaleaf-toolkit"
```

> [!WARNING]
>
> إذا كان المجلد يحتوي بالفعل على تثبيت، فاستخدمه كما هو، أو اختر مجلدًا آخر لنسخة جديدة. لا تهيّئ إعدادات جديدة فوق نشر قائم.

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

تابع مع [2. تعرّف على الـ Toolkit](https://ayakaleaf-pro.mintlify.site/ar/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md).


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