# Мастер настройки

Мастер запускается при первом старте CLI и повторно командой:

```bash
iola master
```

Мастер обновляет только выбранные компоненты и не сбрасывает остальные настройки.

Перед выбором компонентов CLI проверяет окружение и показывает статус каждого пункта: `готово` или `не настроено`.

## Компоненты

### 1. workspace и контекст

Создает рабочую среду текущей папки: `.iola/`, `IOLA.md` и `.iola/context.md`.

Нужно, если агент будет работать с локальными файлами, документами, задачами, артефактами и контекстом проекта.

### 2. policy analyst

Включает профиль разрешений для аналитической работы: открытые данные, отчеты, безопасные локальные операции.

### 3. IOLA локальная модель

Проверяет штатную локальную модель IOLA и готовит ее к работе через доступный runtime.

Если модель уже скачана и доступна, пункт показывается как `готово`.

После настройки локальную модель можно менять в интерактивном агенте через `/model`. Помимо штатной IOLA-модели можно выбрать установленную или рекомендуемую Ollama-модель, либо вручную ввести имя любой модели из библиотеки Ollama.

### 4. YandexGPT API

Настраивает профиль YandexGPT и сохраняет API key плюс folder ID локально у пользователя.

Российский провайдер вызывается напрямую, без gateway/proxy.

### 5. GigaChat API

Настраивает профиль GigaChat и сохраняет authorization key локально у пользователя.

Российский провайдер вызывается напрямую, без gateway/proxy.

### 6. OpenAI API

Настраивает профиль OpenAI и сохраняет API-ключ локально у пользователя.

После сохранения ключа мастер предлагает выбрать модель из доступного списка.

### 7. OpenRouter API

Настраивает профиль OpenRouter и сохраняет API-ключ локально у пользователя.

После сохранения ключа мастер предлагает выбрать разработчика моделей OpenRouter, а затем одну из свежих моделей для текстовой работы. В списке моделей `0` возвращает к выбору разработчика.

### 8. Codex CLI

Проверяет наличие Codex CLI и авторизации. Если Codex уже установлен и вход выполнен, пункт показывается как `готово`.

### 9. MCP для Codex

Добавляет MCP-сервер открытых данных Йошкар-Олы в Codex. Этот пункт можно запускать повторно для обновления подключения.

### 10. 7-Zip / архивы

Проверяет 7-Zip. Если архиватор не найден, мастер устанавливает его.

Нужен для чтения, распаковки, сборки и индексирования архивов.

### 11. Индекс локальных документов

Готовит режим чтения файлов и подсказывает команду индексирования локальной папки:

```bash
iola index folder ./docs
```

### 12. Browser runtime

Проверяет Playwright/Chromium runtime. Нужен для браузерного агента.

### 13. Ollama

Опциональный локальный runtime для выбора сторонних моделей из библиотеки Ollama.

Если runtime уже установлен, пункт показывается как `готово`.

### 14. Yandex Geocoder API

Сохраняет ключ Yandex Geocoder API локально у пользователя и проверяет его тестовым запросом.

Нужен для будущих geo-skills: поиск объектов рядом с адресом, ссылки на карту, определение расстояний и уточнение населенного пункта.

Инструкция по получению ключа: [Yandex Geocoder API key](Yandex-Geocoder-API-key).

### 15. Облачный диск

Подключает личный облачный диск пользователя:

- Яндекс Диск;
- Облако Mail.ru.

Секреты сохраняются локально в `~/.iola/secrets.json`. Резервные копии CLI не включают OAuth-токены, пароли и API-ключи.

Инструкция: [Облачные диски](Облачные-диски).

### 16. Yandex Connector

Настраивает единый коннектор пользовательских сервисов Яндекса.

Первый контур:

- Yandex ID;
- Яндекс Диск.

Мастер не спрашивает список сервисов. Он подключает коннектор с максимальным набором OAuth-прав, а активные функции CLI выбираются позже командой `/yandex` в интерактивном CLI или `iola yandex menu` в терминале.

В коннектор также заложены категории для проверки: Почта, Календарь, Контакты, Wiki, Tracker, Forms, Документы/360. Такси, Маркет и Доставка записаны в backlog только как подготовка ссылки, маршрута или списка без заказа и оплаты.

Инструкция: [Yandex Connector](Yandex-Connector).

## Повторный запуск

Если компонент уже настроен, его можно не выбирать. Если нужно переустановить или обновить компонент, выберите его номер вручную.
