home-assistant.io/source/_components/image_processing.microsoft_face_detect.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 detect	Instructions how to integrate microsoft face detect into Home Assistant.	2017-01-25 00:00	true	false	true	true	microsoft.png	Image Processing	false	0.37

The microsoft_face_detect image processing platform lets you use Microsoft Face identify API through Home Assistant. This platform allow you do detect face on camera and fire a 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_detect
   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.
• attributes array (Optional): Default age,gender. Attributes for search on picture. Supported: age, gender, glasses