home-assistant.io/source/_components/image_processing.microsoft_face_identify.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, featured, ha_release

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	featured	ha_release
page	Microsoft Face Identify	Instructions on how to integrate Microsoft Face Identify into Home Assistant.	2017-01-25 00:00	true	false	true	true	microsoft.png	Image Processing	false	0.37

The microsoft_face_identify image processing platform lets you use Microsoft Face identify API through Home Assistant. This platform allow you do identify persons on camera and fire an event with attributes.

Please refer to the component configuration on how to setup the API key.

For using the result inside an automation rule, take a look at the component page.

{% linkable_title Configuration Home Assistant %}

# Example configuration.yaml entry
image_processing:
  - platform: microsoft_face_identify
    group: family
    source:
      - entity_id: camera.door

Configuration variables:

• group (Required): Micrsoft face group to detect person from it.
• confidence (Optional): The minimum of confidence in percent to process with Home Assistant. Defaults to 80.
• source array (Required): List of image sources.
  • entity_id (Required): A camera entity id to get picture from.
  • name (Optional): This parameter allows you to override the name of your image_processing entity.