{"id":28304779,"url":"https://github.com/black-roland/homeassistant-vkcloud-vision","last_synced_at":"2026-05-04T14:43:14.483Z","repository":{"id":294771473,"uuid":"978386426","full_name":"black-roland/homeassistant-vkcloud-vision","owner":"black-roland","description":"VK Cloud Vision for Home Assistant: AI-powered object recognition from cameras and more","archived":false,"fork":false,"pushed_at":"2025-06-15T03:34:32.000Z","size":85,"stargazers_count":6,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-15T04:18:41.451Z","etag":null,"topics":["computer-vision","home-assistant","home-assistant-integration","homeassistant","object-detection","surveillance","vk-cloud"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/black-roland.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yaml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":["https://mansmarthome.info/donate/"]}},"created_at":"2025-05-05T22:56:20.000Z","updated_at":"2025-06-15T03:34:35.000Z","dependencies_parsed_at":"2025-05-22T01:28:33.786Z","dependency_job_id":"fe2e550e-2118-4837-a7da-e467b03c5197","html_url":"https://github.com/black-roland/homeassistant-vkcloud-vision","commit_stats":null,"previous_names":["black-roland/homeassistant-vkcloud-vision"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/black-roland/homeassistant-vkcloud-vision","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/black-roland%2Fhomeassistant-vkcloud-vision","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/black-roland%2Fhomeassistant-vkcloud-vision/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/black-roland%2Fhomeassistant-vkcloud-vision/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/black-roland%2Fhomeassistant-vkcloud-vision/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/black-roland","download_url":"https://codeload.github.com/black-roland/homeassistant-vkcloud-vision/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/black-roland%2Fhomeassistant-vkcloud-vision/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261389796,"owners_count":23151423,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["computer-vision","home-assistant","home-assistant-integration","homeassistant","object-detection","surveillance","vk-cloud"],"created_at":"2025-05-24T01:11:41.445Z","updated_at":"2026-05-04T14:43:14.477Z","avatar_url":"https://github.com/black-roland.png","language":"Python","funding_links":["https://mansmarthome.info/donate/"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  See \u003ca href=\"#vk-cloud-vision-for-home-assistant\"\u003edescription in English\u003c/a\u003e below 👇\n  \u003cbr\u003e\n  \u003cbr\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eVK Cloud Vision для Home Assistant\u003c/h1\u003e\n\n  [![Добавить репозиторий в HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=black-roland\u0026repository=homeassistant-vkcloud-vision\u0026category=integration)\n  [![Настроить интеграцию](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=vkcloud_vision)\n\n  \u003cp\u003eИнтеграция добавляет поддержку облачного распознавания объектов и текста через VK Cloud Vision.\u003cbr\u003eИспользуйте возможности компьютерного зрения для создания автоматизаций на основе анализа изображений с камер видеонаблюдения.\u003c/p\u003e\n\u003c/div\u003e\n\n## Возможности\n\n- **Распознавание объектов** (людей, животных) и **автомобильных номеров**.\n- **Распознавание лиц**: определение уже знакомых людей и автоматическое добавление новых лиц в базу.\n- **Распознавание текста**: например, надписей на автомобилях и других объектах.\n- Сохранение стоп-кадров с разметкой обнаруженных объектов.\n- Blueprints для реализации распространённых сценариев.\n\nVK Cloud Vision — это облачный сервис, плата за который взимается в соответствии с [тарифами](https://cloud.vk.com/docs/ru/ml/vision/tariffication). При первой регистрации можно получить [приветственные бонусы](https://cloud.vk.com/bonus/).\n\n\u003cp float=\"left\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/62a12925-52f0-48c8-968f-c1776637c200\" width=\"400\" alt=\"Сигнализация с распознаванием объектов\" /\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/5b8aaeb0-5566-4552-a6e8-ccdc79373b36\" width=\"400\" alt=\"Распознавание автомобильных номеров\" /\u003e\n\u003c/p\u003e\n\n## Установка и настройка\n\n### Подготовка\n\n1. Зарегистрируйтесь в [VK Cloud](https://cloud.vk.com/app/signup/).\n2. Получите **Идентификатор клиента** и **Секретный ключ** в разделе «[Доступ через идентификатор клиента и секретный ключ](https://msk.cloud.vk.com/app/services/machinelearning/vision/access/)».\n3. Сохраните полученные данные.\n\n### Установка\n\n1. [Скачайте интеграцию](https://my.home-assistant.io/redirect/hacs_repository/?owner=black-roland\u0026repository=homeassistant-vkcloud-vision\u0026category=integration) через HACS.\n2. Перезапустите Home Assistant.\n3. Перейдите в **Настройки → Устройства и службы → Добавить интеграцию** или используйте [кнопку настройки](https://my.home-assistant.io/redirect/config_flow_start/?domain=vkcloud_vision).\n4. Введите **Идентификатор клиента** и **Секретный ключ**, полученные в личном кабинете VK Cloud.\n\n## Использование на практике\n\n### Интеграция с motionEye\n\nИнтеграция с VK Cloud Vision занимается только распознаванием объектов, и ей нужен внешний триггер, который запустит распознавание. Про использование [motionEye в качестве такого триггера можно почитать тут](https://mansmarthome.info/posts/vidieonabliudieniie/motioneye-raspoznavaniie-obiektov-v-home-assistant-za-paru-shaghov/).\n\n### Охранная сигнализация с облачным распознаванием объектов\n\n[![Импорт blueprint](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fyaml.mansmarthome.info%2Froland%2F84cc0d91a7dd4517be28b3ee53f3a6b3%2Fdownload%2FHEAD%2Fobject_detection_triggered_alarm.yaml)\n\nАктивирует сигнализацию при обнаружении людей или транспортных средств, игнорируя ложные срабатывания (например, движение веток или животных).\n\nОсновные функции:\n- Активация только в выбранных режимах охраны;\n- Проверка на наличие важных объектов («Человек», «Автомобиль», «Грузовик», «Автобус»);\n- Сохранение стоп-кадров с разметкой объектов;\n- Логирование результатов обнаружения.\n\n### Система контроля доступа для транспорта\n\n[![Импорт blueprint](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fyaml.mansmarthome.info%2Froland%2F84cc0d91a7dd4517be28b3ee53f3a6b3%2Fraw%2FHEAD%2Flpr_triggered_actions.yaml)\n\nАвтоматическое открытие ворот и выполнение других действий для «своих» машин и спецтранспорта.\n\nОсновные функции:\n- Распознавание номеров «своих» автомобилей;\n- Идентификация спецтранспорта (скорая, спасатели, пожарные);\n- Обнаружение служебного транспорта (курьеры, доставка);\n- Гибкая настройка действий для разных категорий.\n\n### Распознавание лиц: идентификация и пользовательские действия\n\n[![Импорт blueprint](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fyaml.mansmarthome.info%2Froland%2F84cc0d91a7dd4517be28b3ee53f3a6b3%2Fraw%2FHEAD%2Fface_recognition_triggered_actions.yaml)\n\nРаспознаёт лица знакомых и незнакомых людей, позволяя гибко настраивать сценарии под каждого.\n\nОсновные функции:\n- Идентификация людей по базе сохранённых лиц;\n- Настраиваемые действия для знакомых (например, приветствие, открытие замка);\n- Отдельные действия для незнакомцев (например, оповещение, запись видео);\n- Переопределение режима обучения для автоматического добавления новых лиц.\n\n#### Первоначальная настройка\n\nЕсли вы только начинаете использовать распознавание лиц, то база сервиса изначально пуста. Интеграция поддерживает **режим обучения**, чтобы не добавлять каждое лицо вручную:\n1. Перейдите в **Настройки → Устройства и службы → [VK Cloud Vision](https://my.home-assistant.io/redirect/integration/?domain=vkcloud_vision) → Настроить → Распознавание лиц**.\n2. Включите **Режим обучения**.\n3. Сохраните настройки.\n\nВ режиме обучения все новые лица, попадающие в кадр, будут автоматически сохраняться в базу. Каждому новому человеку будет присвоен тег с порядковым номером (например, `person1`, `person2`).\n\n\u003e [!IMPORTANT]\n\u003e Не забудьте **отключить режим обучения**, когда все нужные лица будут добавлены — иначе посторонние и гости тоже попадут в базу.\n\n\u003e [!TIP]\n\u003e Если лицо стало распознаваться хуже (например, из-за смены причёски, очков или бороды) — включите режим обучения на несколько дней. Интеграция обновит сохранённые образцы под текущую внешность.\n\n### Оповещение при обнаружении объектов\n\n[![Импорт blueprint](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fyaml.mansmarthome.info%2Froland%2F84cc0d91a7dd4517be28b3ee53f3a6b3%2Fdownload%2FHEAD%2Fmotion_triggered_object_detection_notifications.yaml)\n\nОтправляет push-уведомления при обнаружении заданных объектов с прикреплением стоп-кадра и списком распознанных объектов. [Логирует все обнаруженные объекты в журнал (logbook)](https://yaml.mansmarthome.info/roland/84cc0d91a7dd4517be28b3ee53f3a6b3#logbook).\n\n\u003cp float=\"left\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/a228f223-dbc4-4311-b02f-ae7331abe259\" width=\"400\" alt=\"Карточка с изображением с камеры\" /\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/f97cda10-880a-4ab5-b088-1916924501e5\" width=\"400\" alt=\"Журнал\" /\u003e\n\u003c/p\u003e\n\n## Доступные сервисы\n\nИнтеграция предоставляет два действия для анализа изображений с камер:\n\n### `vkcloud_vision.detect_objects`\n\nОбнаруживает объекты, сцены или автомобильные номера на изображениях с камеры. Позволяет сохранять стоп-кадры с рамками вокруг обнаруженных объектов.\n\nПараметры:\n\n- **modes** (необязательное, по умолчанию `[\"multiobject\"]`) — режимы распознавания. Доступные варианты:\n  - `multiobject`: Искать на изображении мультиобъекты — объекты и все множество боксов всех найденных объектов.\n  - `car_number`: Распознавание автомобильных номеров.\n  - `object`: Искать на изображении объекты.\n  - `object2`: Искать на изображении объекты (версия модели v2 — распознает объекты, принадлежащие большему количеству классов).\n  - `scene`: Распознавание сцен.\n  - `pedestrian`: Искать на изображении людей (более точно определяет множество боксов всех людей на изображении).\n  - `selfie`: Определение селфи.\n- **prob_threshold** (необязательное, по умолчанию `0.1`): Минимальная вероятность (от 0 до 1) для включения обнаруженных объектов в результаты. Например, значение 0.1 означает, что будут учитываться только объекты с точностью обнаружения не менее 10%.\n- **file_out** (необязательное): Путь для сохранения стоп-кадра с разметкой (например, `/config/www/vkcloud_vision_snapshot.jpg`).\n- **bounding_boxes** (необязательное, по умолчанию `rus`): Стиль отображения рамок:\n  - `none`: Не отображать рамки;\n  - `no_labels`: Только рамки без подписей;\n  - `rus`: Подписи на русском языке;\n  - `eng`: Подписи на английском языке.\n- **num_snapshots** (необязательное, по умолчанию `1`): Количество последовательных стоп-кадров, снимаемых с камеры заданным интервалом. Повышает точность распознавания, особенно для движущихся объектов.\n- **snapshot_interval_sec** (необязательное, по умолчанию `0.5`): Интервал в секундах между стоп-кадрами.\n- **max_retries** (необязательное, по умолчанию `5`): Количество попыток повторного выполнения запросов к API в случае таймаутов или временных ошибок.\n\n\nПример использования:\n\n```yaml\naction: vkcloud_vision.detect_objects\ntarget:\n  entity_id: camera.front_door\ndata:\n  modes:\n    - multiobject\n    - car_number\n  file_out: /config/www/vkcloud_vision_snapshot.jpg\n  bounding_boxes: rus\n```\n\n### `vkcloud_vision.recognize_faces`\n\nОпределяет лица на изображении, сравнивает их с сохранёнными в базе, а при включённом режиме обучения автоматически сохраняет новые лица.\n\nПараметры:\n\n- **space** (обязательное) — числовой идентификатор пространства. В каждом пространстве хранится свой набор лиц, что удобно для разделения сценариев: например, space 0 для домашних, а space 1 для офиса.\n- **create_new** (необязательное) — если `true`, то новые лица будут автоматически добавляться в пространство. Значение по умолчанию зависит от галочки «Режим обучения» в параметрах интеграции.\n- **update_embedding** (необязательное) — если `true`, то векторное представление лица обновляется при каждом совпадении, улучшая точность распознавания в будущем. Отключите для изображений низкого качества. Значение по умолчанию зависит от настройки «Режим обучения».\n\nДействие возвращает структурированный ответ со списком найденных лиц, координатами, степенью похожести и дополнительными атрибутами (пол, возраст, эмоции).\n\n\nПример использования:\n\n```yaml\naction: vkcloud_vision.recognize_faces\ntarget:\n  entity_id: camera.front_door\ndata:\n  space: 0\n```\n\n#### Настройка режима обучения\n\nРежим обучения включается в параметрах интеграции (*Настройки → Устройства и службы → VK Cloud Vision → Настроить → Распознавание лиц*). Когда режим активен, оба параметра (`create_new` и `update_embedding`) по умолчанию включены. Вы по-прежнему можете переопределить их в явном виде при вызове действия.\n\n#### Очистка пространства\n\nВ параметрах интеграции также доступна опция *Очистка базы лиц*, которая полностью удаляет все данные из выбранного пространства.\n\n### `vkcloud_vision.recognize_text`\n\nРаспознает текст на снимках с камеры (например, надписи на автомобилях и других объектах).\n\nПараметры:\n\n- **lang** (необязательное): Язык текста для повышения точности распознавания. Доступные значения: `rus` (русский), `eng` (английский). По умолчанию используется автоопределение.\n\nПример использования:\n\n```yaml\naction: vkcloud_vision.recognize_text\ntarget:\n  entity_id: camera.front_door\ndata:\n  lang: rus\n```\n\n## Поддержка автора\n\nЕсли интеграция оказалась полезной, вы можете [угостить автора чашечкой кофе](https://mansmarthome.info/donate/?utm_source=github\u0026utm_medium=referral\u0026utm_campaign=vision#donationalerts). Ваша благодарность ценится!\n\n#### Благодарности\n\nОгромное спасибо всем, кто поддерживает этот проект:\n\n![Спасибо][donors-list]\n\n## Уведомление\n\nДанная интеграция является неофициальной и не связана с VK Cloud. VK Cloud Vision — это сервис, предоставляемый VK Cloud.\n\nДанная интеграция не является официальным продуктом VK Cloud и не поддерживается VK.\n\n---\n\n# VK Cloud Vision for Home Assistant\n\n[![Add repository to HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=black-roland\u0026repository=homeassistant-vkcloud-vision\u0026category=integration)\n[![Configure Integration](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=vkcloud_vision)\n\nThis integration brings cloud-based object and text recognition to Home Assistant using the [VK Cloud Vision](https://cloud.vk.com/vision/) service. Leverage computer vision to create automations based on image analysis from surveillance cameras.\n\n## Key Features\n\n- **Object and license plate detection** using the `vkcloud_vision.detect_objects` action.\n- **Face recognition** with person identification and automatic enrollment of new faces.\n- **Text recognition** on scene photos (e.g., vehicle inscriptions) using the `vkcloud_vision.recognize_text` action.\n- Create automations based on image analysis from surveillance cameras.\n- Save snapshots with annotations of detected objects.\n\n## Installation and Setup\n\n### Prerequisites\n\n1. Sign up at [VK Cloud](https://cloud.vk.com/app/signup/).\n2. Get **Client ID** and **Client Secret** in the [dashboard](https://msk.cloud.vk.com/app/services/machinelearning/vision/access/).\n3. Save the keys for integration setup.\n\n### Installation\n\n1. Open **HACS → Integrations**.\n2. Click the three-dot menu in the top right and select **Custom repositories**.\n3. Add the repository: `https://github.com/black-roland/homeassistant-vkcloud-vision`, select **Integration** as the category.\n4. Find and install the **VK Cloud Vision** integration.\n5. Restart Home Assistant.\n\n### Configuration\n\n1. Go to **Settings → Devices \u0026 Services → Add Integration** or use the [configuration button](https://my.home-assistant.io/redirect/config_flow_start/?domain=vkcloud_vision).\n2. Enter the **Client ID** and **Client Secret** obtained from VK Cloud.\n3. Save the configuration and restart Home Assistant if prompted.\n\n## Donations\n\nIf this integration has been useful to you, consider [buying the author a coffee](https://www.donationalerts.com/r/mansmarthome). Your gratitude is appreciated!\n\n#### Thank you\n\n![Thank you][donors-list]\n\n## Notice\n\nThis is a community project, not affiliated with VK Cloud. VK Cloud Vision is a service provided by VK Cloud.\n\nThis integration is not an official VK Cloud product and is not supported by VK.\n\n[donors-list]: https://github.com/user-attachments/assets/42db246f-ac83-46f8-8cae-1bb526ad0a4e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblack-roland%2Fhomeassistant-vkcloud-vision","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblack-roland%2Fhomeassistant-vkcloud-vision","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblack-roland%2Fhomeassistant-vkcloud-vision/lists"}