> For the complete documentation index, see [llms.txt](https://docs.mikopbx.com/mikopbx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mikopbx.com/mikopbx/modules/miko/module-local-speech-to-text/quick-start.md).

# Быстрый старт

### Установка модуля

1. Откройте веб-интерфейс MikoPBX.
2. Перейдите в раздел **"Модули"** → **"Маркетплейс модулей"**.

<figure><img src="/files/5YieJLPTR2xWxDqDsV2O" alt=""><figcaption><p>Раздел "Маркетплейс модулей"</p></figcaption></figure>

3. Найдите **Модуль локальной транскрибации** и установите его.
4. Перейдите в список установленных модулей и включите модуль.

<figure><img src="/files/9SkH1YplFUXW5lTdUECV" alt=""><figcaption><p>Включение модуля "Локальная транскрибация"</p></figcaption></figure>

5. Откройте страницу модуля, нажав на иконку "Настройки", справа от версии модуля.

<figure><img src="/files/k0DJXoLKD0VArSM0s71H" alt=""><figcaption><p>Переход на страницу модуля</p></figcaption></figure>

### Настройка модуля

1. Во вкладке "**Настройки"** оставьте язык "**Определять автоматически"** или выберите основной язык звонков.

<figure><img src="/files/VhYrTfC7PeIGSyHnpWmi" alt=""><figcaption><p>Выбор языка распознавания</p></figcaption></figure>

2. Во вкладке "**Маркетплейс моделей"** выберите модель "**Large V3 Turbo"** или **"Podlodka Turbo"** (для русского языка). Это рекомендуемые варианты для рабочей расшифровки звонков.

Нажмите "**Сохранить модель**".

<figure><img src="/files/IQhbspGO9fRqxQT2o1hg" alt=""><figcaption><p>Выбор модели для распознавания</p></figcaption></figure>

3. Перейдите во вкладку "**Воркеры**" нажмите "**Создать API-ключ"** и сразу скопируйте ключ.

<figure><img src="/files/u3QlNkNlyv8GjAmEoB6P" alt=""><figcaption><p>Создание API ключа для внешней работы с модулем</p></figcaption></figure>

4. Откройте приложение-обработчик "**MIKO AI Worker**" на Mac. На первом шаге онбоардинга выберите язык интерфейса. Нажмите "**Далее**".

<figure><img src="/files/3ixmzaRF23okCtfzPBcY" alt=""><figcaption><p>Выбор языка онбоардинга и приложения</p></figcaption></figure>

5. Перейдите на Шаг 3 (нажмите "**Далее**" на Шаге 2). Введите адрес Вашей MikoPBX в формате `https://...` и задайте понятное имя обработчика.

Нажмите "**Проверить соединение**", потом "**Далее**".

<figure><img src="/files/W0Me4JNCccPnpZuM9xxE" alt=""><figcaption><p>Шаг "Подключение к MikoPBX"</p></figcaption></figure>

6. На шаге "**TLS и доверие сертификату"** выберите, проверять ли сертификат PBX. Если у Вас есть сертификат - включите проверку и укажите PEM-файл CA.

<figure><img src="/files/GjGLEnVbtJKUPmK8xWOx" alt=""><figcaption><p>Шаг "TLS и доверие сертификату"</p></figcaption></figure>

7. На шаге **"Распознавание речи",** вставьте созданный STT воркер token, нажмите **"Проверить токен"**, затем **"Зарегистрировать распознавание речи"**.

Нажмите "**Далее**".

<figure><img src="/files/dea7FTVqj9kDX2UhNEAC" alt=""><figcaption><p>Шаг "Распознавание речи"</p></figcaption></figure>

8. Если ИИ Аналитика на этом Mac не нужна, пропустите шаг **AI Analysis (**&#x43D;ажмите **"Далее".**

{% hint style="info" %}
Подробнее про модуль "ИИ Супервайзер" можно прочитать <mark style="color:red;">здесь</mark>.
{% endhint %}

9. На финальном шаге включите **"Запускать при входе"**, если обработчик должен запускаться вместе с macOS.

Нажмите "**Открыть MIKO AI Worker**".

<figure><img src="/files/KY4AxAxrgiXGoOeKSd4v" alt=""><figcaption><p>Итог настройки, выбор опции запуска при входе в MacOS</p></figcaption></figure>

Будет загружена модель с ресурса [Hugging Face](https://huggingface.co/), после этого начнется процесс расшифровки записей, переданных со станции. Можно отключить доступ к внешним ресурсам, локальной сети со станцией будет достаточно для дальнейшей работы.

Результат расшифровки Вы сможете найти в разделе "**Транскрипты**".

<figure><img src="/files/qbXyCO0MKP5b1MWGdou1" alt=""><figcaption><p>Процесс расшифровки записи</p></figcaption></figure>

Более подробную инструкцию по настройке обработчика можно посмотреть [здесь](/mikopbx/modules/miko/module-local-speech-to-text/miko-ai-worker.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.mikopbx.com/mikopbx/modules/miko/module-local-speech-to-text/quick-start.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.