See description in English below 👇

Интеграция YandexGPT для Home Assistant

Ассистент на основе YandexGPT для Home Assistant:

• Интеграция позволяет «общаться» с ассистентом из интерфейса Home Assistant.
• У ассистента можно узнавать показания датчиков, состояние света и других устройств. То есть ассистент на базе YandexGPT знает все про умный дом и устройства в нем.
• С помощью приложения Home Assistant, установленного на смартфоне или умных часах, можно общаться с ассистентом голосом.
• Интеграция может служить «мозгом» для создания DIY-умной колонки на базе ESPHome, если помимо YandexGPT добавить в Home Assistant синтез и распознавание речи.
• YandexGPT можно использовать в автоматизациях, например, для создания чат-бота в Telegram.
• Кроме того, интеграция позволяет генерировать изображения с помощью YandexART.

YandexGPT — это облачный сервис, плата за который взимается в соответствии с тарифами Yandex Cloud. При первой регистрации можно получить стартовый грант.

Установка и настройка

Инструкции по получению ключа API и настройке интеграции можно найти в wiki.

TLDR: Добавьте интеграцию, используя голубые кнопки выше, а затем получите идентификатор каталога и ключ API. Сервисному аккаунту нужно указать следующие роли: ai.languageModels.user и ai.imageGeneration.user.

Примеры использования

Примеры использования можно найти в моем блоге. Кроме того, про первую версию интеграции я рассказывал на YouTube.

Спонсорство

Интеграция оказалась полезной? Хотите сказать спасибо? Кофе автору — ваша благодарность. ☕ На кофе

Укажите в комментарии свой никнейм на GitHub, чтобы я мог упомянуть вас в README 🙂

Также буду рад помощи с документацией и кодом. Спасибо!

---

YandexGPT integration for Home Assistant

The assistant based on YandexGPT for Home Assistant:

• The integration allows you to chat with the assistant from the Home Assistant UI.
• You can ask the assistant about sensor readings, status of lights and other devices. So the assistant knows everything about your smart home and the devices in it.
• You can chat with the assistant using Home Assistant app on a watch or smartphone.
• Integration can be the «brain» of a DIY smart speaker based on ESPHome if in addition to YandexGPT you would add speech synthesis and recognition to Home Assistant.
• YandexGPT can be used in automations. For example, this way you can create a chatbot for Telegram or any other supported messenger.
• In addition to YandexGPT, the integration provides image generation using YandexART.

YandexGPT is a cloud service. Fees are charged according to Yandex Cloud tariffs.

Set up

Use blue buttons above to install and configure the integration. Please check out the official documentation on how to retrieve folder ID and API key. For a service account it's required to set the following roles: ai.languageModels.user and ai.imageGeneration.user.