HACS - Home Assistant Community Store (магазин пользовательских интеграций Home Assistant) - это дополнение к Home Assistant, открывающее доступ к огромному количеству различных интеграций и новых элементов интерфейса, написанных программистами-энтузиастами, пользователями Home Assistant.
В отличии от магазина нативных интеграций, который встроен в Home Assistant по умолчанию, стабильная работа и постоянная поддержка интеграций, установленных из HACS, не гарантируется, так как эти решения созданы, как правило, одним разработчиком по его собственной инициативе и проходят тестирование на живых пользователях. Однако популярные пользовательские интеграции работают хорошо и обновляются быстро, и даже в случае прекращения поддержки со стороны разработчика по какой-то причине у таких интеграций появляется форк (ответвление разработки проекта) от другого энтузиаста, и они продолжают свой жизненный путь.
HACS по умолчанию не установлен в Home Assistant, его нужно установить вручную. Инструкция по установке HACS приведена на их официальном сайте:
Приведу здесь поясняющие скриншоты процесса установки.
Установка дополнения HACS
Для начала нужно перейти по этой ссылке, откроется страница редиректа в ваш Home Assistant:
Убедитесь, что в поле "Your instance URL" введён правильный локальный адрес вашего Home Assistant, отредактируйте при необходимости. После этого нажимаем "Open Link". Подтверждаем свои намерения:
В Home Assistant откроется страница загрузки дополнения HACS, где нажимаем кнопку УСТАНОВИТЬ:
Минутку ждём окончания процесса загрузки и установки, после чего включаем опцию "Автозагрузка" нажимаем ЗАПУСТИТЬ:
Дополнение запущено и работает:
Перезапускаем Home Assistant - меню Настройки -> три точки справа вверху -> Перезапустить Home Assistant и подтверждаем перезапуск:
Далее инструкция требует очистить кэш браузера, иначе HACS может не появиться в списке интеграций на следующем этапе настройки. Я обычно сначала проверяю, не возникнет ли проблем без очистки кэша, и очищаю его лишь при необходимости, чтобы потом не логиниться заново на всех сайтах.
Установка интеграции HACS
Итак, дополнение HACS загружено, но чтобы получить интерфейс его управления в Home Assistant, нужно установить интеграцию HACS (Дополнение и интеграция - это суть разные вещи. Дополнение - самостоятельное ПО, интеграция - часть ядра Home Assistant). Инструкция по установке интеграции на сайте HACS:
Для установки интеграции пройдём в меню Настройки -> Устройства и службы (Интеграции,...) -> кнопка Добавить интеграцию -> набираем HACS и нажимаем на строку интеграции, чтобы начать её установку:
В следующем окне устанавливаем все галочки и нажимаем ПОДТВЕРДИТЬ:
В следующем окне нам будет предложено скопировать код авторизации для того, чтобы ввести его на GitHub:
Исходный код всех пользовательских интеграций в HACS является открытым и находятся на GitHub (как и весь код Home Assistant). Интеграция HACS, по сути, открывает удобный интерфейс для гитхаба, где будут отображаться только пользовательские интеграции Home Assistant. Но для доступа к исходному коду необходимо быть зарегистрированным на портале GitHub. Если вы там уже зарегистрированы, то нажав на ссылку на предыдущем скриншоте вам будет предложено залогиниться на GitHub:
Регистрация аккаунта на GitHub
Если же такой регистрации у вас ещё нет, то регистрируемся на сайте, нажав "Create an account" (см. предыдущий скриншот):
Нажимаем Continue и решаем какую-нибудь забавную капчу, которая будет предложена:
Проверяем почту и вводим код подтверждения своего адреса:
После чего нам будет сообщено, что аккаунт успешно создан, вводим логин и пароль и нажимаем "Sign In":
Регистрация HACS на GitHub
Далее нам будет предложено активировать устройство:
У меня на гитхабе уже есть один аккаунт, поэтому в этом списке две строки. Напротив вновь созданного аккаунта нажимаем кнопку Continue и вводим тот самый код активации, который мы получили в Home Assistant. Если в Home Assistant окно с кодом уже пропало, то можно повторно запустить установку интеграции и получить новый код:
Нажав Continue, мы увидим окно подтверждения авторизации hacs, где нажимаем кнопку "Authorize hacs":
GitHub сообщит об успешном подключении устройства (Home Assistant):
Завершение установки HACS
Снова возвращаемся в окно Home Assistant, где через пару секунд появится сообщение об успешной установке интеграции HACS, нажимаем ГОТОВО:
Если же этого не произошло, и там по прежнему висит окно с кодом, значит он уже просрочен, и нужно выполнить процедуру повторно - закрыть окно с кодом и начать установку интеграции HACS ещё раз (Меню Настройки-Интеграции-HACS), будет выдан новый код, который нужно ввести на гитхабе. Я пока писал эту инструкцию и отвлекался на текст, код мне пришлось вводить трижды, прежде чем он сработал.
Теперь в левом меню Home Assistant появился пункт магазина HACS, нажав который увидим список доступных для скачивания и установки пользовательских интеграций:
На этом всё. Установка HACS завершена.
Здесь стоит отметить, что далеко не все пользовательские интеграции зарегистрированы в HACS. Огромное количество различных решений для Home Assistant существует на GitHub и вне HACS. Некоторые из таких решений требуют ручного добавления ссылки на пользовательский репозиторий, а некоторые вообще ничего не требуют, и их просто нужно скачать с GitHub и положить в папку /homeassistant/custom_components вашего Home Assistant. В каждом случае разработчик пишет инструкцию по установке и настройке своей интеграции, нужно просто ей следовать, и как правило всегда всё работает.