---
license: mit
library_name: libreyolo
pipeline_tag: object-detection
tags:
  - face-detection
  - onnx
  - libreyolo
---

# librefacerec-det

Lightweight face detector with 5 facial landmarks: the default upstream
detector for LibreYOLO's facial-recognition (`embed`) task. Detected boxes
and landmarks feed the canonical 112x112 similarity alignment before
embedding. Auto-downloaded on first use; any LibreYOLO detector or custom
callable can be substituted via `face_detector=`.

## Provenance and license

- Mirrored unmodified from the OpenCV Zoo YuNet release
  (`face_detection_yunet_2023mar.onnx`), renamed to `librefacerec-det.onnx`.
- Weights license: MIT (LICENSE shipped alongside the model in
  [opencv_zoo](https://github.com/opencv/opencv_zoo/tree/main/models/face_detection_yunet),
  copyright Shiqi Yu).
- SHA-256: `8f2383e4dd3cfbb4553ea8718107fc0423210dc964f9f4280604804ed2552fa4`
  (verified identical to upstream at mirror time, 2026-07-28).
- Trained by its authors on the WIDER FACE dataset; see the upstream
  repository for details.

## Notes

Runs via OpenCV's bundled `cv2.FaceDetectorYN` (no extra dependency in
LibreYOLO). Measured 2026-07-28 in the LibreYOLO pipeline on the 2000
funneled LFW dev-test images: a face was found in every image, so no pair
was lost to detection failure. LFW is a frontal, well-lit distribution;
expect lower recall on profile views, small faces, and difficult lighting.