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

Если при запуске Git macOS предложит установить Command Line Tools, сначала установите их. Если Homebrew отсутствует, установите его по [официальной инструкции](https://brew.sh/).

**2. Добавьте GNU sed в PATH**

Скрипты Toolkit используют параметры GNU sed, которые отклоняет встроенный в macOS BSD sed. Установите [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/ru/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.