From d03131e37a20a2bf636620c2f8523786cc287ea0 Mon Sep 17 00:00:00 2001 From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com> Date: Mon, 9 Jun 2025 20:13:09 -0500 Subject: [PATCH] improve face rec faq --- docs/docs/configuration/face_recognition.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/docs/docs/configuration/face_recognition.md b/docs/docs/configuration/face_recognition.md index 25330e2be..b7265bb87 100644 --- a/docs/docs/configuration/face_recognition.md +++ b/docs/docs/configuration/face_recognition.md @@ -133,6 +133,27 @@ Once front-facing images are performing well, start choosing slightly off-angle ## FAQ +### How do I debug Face Recognition issues? + +Start with the [Usage](#usage) section and re-read the [Model Requirements](#model-requirements) above. + +1. Ensure `person` is being _detected_. A `person` will automatically be scanned by Frigate for a face. Any detected faces will appear in the Train tab in the Frigate UI's Face Library. + + If you are using a Frigate+ or `face` detecting model: + + - Watch the debug view (Settings --> Debug) to ensure that `face` is being detected along with `person`. + - You may need to adjust the `min_score` for the `face` object if faces are not being detected. + + If you are **not** using a Frigate+ or `face` detecting model: + + - Check your `detect` stream resolution and ensure it is sufficiently high enough to capture face details on `person` objects. + - You may need to lower your `detection_threshold` if faces are not being detected. + +2. Any detected faces will then be _recognized_. + + - Make sure you have trained at least one face per the recommendations above. + - Adjust `recognition_threshold` settings per the suggestions [above](#advanced-configuration). + ### Detection does not work well with blurry images? Accuracy is definitely a going to be improved with higher quality cameras / streams. It is important to look at the DORI (Detection Observation Recognition Identification) range of your camera, if that specification is posted. This specification explains the distance from the camera that a person can be detected, observed, recognized, and identified. The identification range is the most relevant here, and the distance listed by the camera is the furthest that face recognition will realistically work.