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
page	Microsoft Face Identify	Instructions 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 a event with identify persons.

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.