README.md

---
library_name: pytorch
license: other
tags:
- real_time
- android
pipeline_tag: object-detection

---

![](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/hrnet_face/web-assets/model_demo.png)

# HRNetFace: Optimized for Qualcomm Devices

Detects attributes (liveness, eye closeness, mask presence, glasses presence, sunglasses presence) that apply to a given face.

This is based on the implementation of HRNetFace found [here](https://github.com/HRNet/HRNet-Facial-Landmark-Detection).
This repository contains pre-exported model files optimized for Qualcomm® devices. You can use the [Qualcomm® AI Hub Models](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/models/hrnet_face) library to export with custom configurations. More details on model performance across various devices, can be found [here](#performance-summary).

Qualcomm AI Hub Models uses [Qualcomm AI Hub Workbench](https://workbench.aihub.qualcomm.com) to compile, profile, and evaluate this model. [Sign up](https://myaccount.qualcomm.com/signup) to run these models on a hosted Qualcomm® device.

## Getting Started
There are two ways to deploy this model on your device:

### Option 1: Download Pre-Exported Models

Below are pre-exported model assets ready for deployment.

| Runtime | Precision | Chipset | SDK Versions | Download |
|---|---|---|---|---|
| ONNX | float | Universal | QAIRT 2.42, ONNX Runtime 1.24.3 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/hrnet_face/releases/v0.54.0/hrnet_face-onnx-float.zip)
| ONNX | w8a8 | Universal | QAIRT 2.42, ONNX Runtime 1.24.3 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/hrnet_face/releases/v0.54.0/hrnet_face-onnx-w8a8.zip)
| QNN_DLC | float | Universal | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/hrnet_face/releases/v0.54.0/hrnet_face-qnn_dlc-float.zip)
| QNN_DLC | w8a8 | Universal | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/hrnet_face/releases/v0.54.0/hrnet_face-qnn_dlc-w8a8.zip)
| TFLITE | float | Universal | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/hrnet_face/releases/v0.54.0/hrnet_face-tflite-float.zip)
| TFLITE | w8a8 | Universal | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/hrnet_face/releases/v0.54.0/hrnet_face-tflite-w8a8.zip)

For more device-specific assets and performance metrics, visit **[HRNetFace on Qualcomm® AI Hub](https://aihub.qualcomm.com/models/hrnet_face)**.


### Option 2: Export with Custom Configurations

Use the [Qualcomm® AI Hub Models](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/models/hrnet_face) Python library to compile and export the model with your own:
- Custom weights (e.g., fine-tuned checkpoints)
- Custom input shapes
- Target device and runtime configurations

This option is ideal if you need to customize the model beyond the default configuration provided here.

See our repository for [HRNetFace on GitHub](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/models/hrnet_face) for usage instructions.

## Model Details

**Model Type:** Model_use_case.object_detection

**Model Stats:**
- Model checkpoint: HR18-COFW.pth
- Input resolution: 256x256
- Number of parameters: 9.68M
- Model size (float): 36.87MB
- Model size (w8a8): 17.7 MB

## Performance Summary
| Model | Runtime | Precision | Chipset | Inference Time (ms) | Peak Memory Range (MB) | Primary Compute Unit
|---|---|---|---|---|---|---
| HRNetFace | ONNX | float | Snapdragon® 8 Elite Gen 5 Mobile | 1.328 ms | 1 - 99 MB | NPU
| HRNetFace | ONNX | float | Snapdragon® 8 Elite Mobile | 1.651 ms | 0 - 95 MB | NPU
| HRNetFace | ONNX | float | Snapdragon® X2 Elite | 1.533 ms | 31 - 31 MB | NPU
| HRNetFace | ONNX | float | Snapdragon® X Elite | 3.359 ms | 30 - 30 MB | NPU
| HRNetFace | ONNX | float | Snapdragon® X Elite | 3.359 ms | 30 - 30 MB | NPU
| HRNetFace | ONNX | float | Snapdragon® 8 Gen 3 Mobile | 2.147 ms | 0 - 149 MB | NPU
| HRNetFace | ONNX | float | Qualcomm® QCS8550 (Proxy) | 2.981 ms | 0 - 37 MB | NPU
| HRNetFace | ONNX | float | Snapdragon® 8 Elite For Galaxy Mobile | 1.651 ms | 0 - 95 MB | NPU
| HRNetFace | ONNX | float | Qualcomm® QCS9075 | 4.743 ms | 2 - 4 MB | NPU
| HRNetFace | ONNX | w8a8 | Snapdragon® 8 Elite Gen 5 Mobile | 0.589 ms | 0 - 106 MB | NPU
| HRNetFace | ONNX | w8a8 | Snapdragon® 8 Elite Mobile | 0.695 ms | 0 - 105 MB | NPU
| HRNetFace | ONNX | w8a8 | Snapdragon® X2 Elite | 0.657 ms | 15 - 15 MB | NPU
| HRNetFace | ONNX | w8a8 | Snapdragon® X Elite | 1.535 ms | 15 - 15 MB | NPU
| HRNetFace | ONNX | w8a8 | Snapdragon® X Elite | 1.535 ms | 15 - 15 MB | NPU
| HRNetFace | ONNX | w8a8 | Snapdragon® 8 Gen 3 Mobile | 0.91 ms | 0 - 154 MB | NPU
| HRNetFace | ONNX | w8a8 | Qualcomm® QCS6490 | 91.191 ms | 17 - 36 MB | CPU
| HRNetFace | ONNX | w8a8 | Qualcomm® QCS8550 (Proxy) | 1.367 ms | 0 - 21 MB | NPU
| HRNetFace | ONNX | w8a8 | Snapdragon® 7 Gen 4 Mobile | 46.653 ms | 17 - 37 MB | CPU
| HRNetFace | ONNX | w8a8 | Qualcomm® QCM6690 | 49.667 ms | 19 - 39 MB | CPU
| HRNetFace | ONNX | w8a8 | Qualcomm® QCS9075 | 1.537 ms | 0 - 3 MB | NPU
| HRNetFace | ONNX | w8a8 | Snapdragon® 8 Elite For Galaxy Mobile | 0.695 ms | 0 - 105 MB | NPU
| HRNetFace | ONNX | w8a8 | Snapdragon® 7 Gen 4 Mobile | 46.653 ms | 17 - 37 MB | CPU
| HRNetFace | QNN_DLC | float | Snapdragon® 8 Elite Gen 5 Mobile | 1.378 ms | 1 - 80 MB | NPU
| HRNetFace | QNN_DLC | float | Snapdragon® 8 Elite Mobile | 1.755 ms | 1 - 78 MB | NPU
| HRNetFace | QNN_DLC | float | Snapdragon® X2 Elite | 1.954 ms | 1 - 1 MB | NPU
| HRNetFace | QNN_DLC | float | Snapdragon® X Elite | 3.662 ms | 1 - 1 MB | NPU
| HRNetFace | QNN_DLC | float | Snapdragon® X Elite | 3.662 ms | 1 - 1 MB | NPU
| HRNetFace | QNN_DLC | float | Snapdragon® 8 Gen 3 Mobile | 2.335 ms | 0 - 121 MB | NPU
| HRNetFace | QNN_DLC | float | Qualcomm® QCS8550 (Proxy) | 3.329 ms | 1 - 3 MB | NPU
| HRNetFace | QNN_DLC | float | Qualcomm® SA8775P | 5.085 ms | 1 - 79 MB | NPU
| HRNetFace | QNN_DLC | float | Qualcomm® SA8775P | 5.085 ms | 1 - 79 MB | NPU
| HRNetFace | QNN_DLC | float | Qualcomm® SA8775P | 5.085 ms | 1 - 79 MB | NPU
| HRNetFace | QNN_DLC | float | Qualcomm® SA7255P | 15.419 ms | 1 - 75 MB | NPU
| HRNetFace | QNN_DLC | float | Qualcomm® QCS8450 (Proxy) | 5.482 ms | 0 - 104 MB | NPU
| HRNetFace | QNN_DLC | float | Qualcomm® SA8295P | 5.643 ms | 1 - 62 MB | NPU
| HRNetFace | QNN_DLC | float | Snapdragon® 8 Elite For Galaxy Mobile | 1.755 ms | 1 - 78 MB | NPU
| HRNetFace | QNN_DLC | float | Qualcomm® QCS9075 | 5.016 ms | 3 - 6 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Snapdragon® 8 Elite Gen 5 Mobile | 0.533 ms | 0 - 74 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Snapdragon® 8 Elite Mobile | 0.671 ms | 0 - 69 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Snapdragon® X2 Elite | 0.876 ms | 0 - 0 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Snapdragon® X Elite | 1.547 ms | 0 - 0 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Snapdragon® X Elite | 1.547 ms | 0 - 0 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Snapdragon® 8 Gen 3 Mobile | 0.899 ms | 0 - 108 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Qualcomm® QCS6490 | 3.86 ms | 2 - 4 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Qualcomm® QCS8550 (Proxy) | 1.355 ms | 0 - 2 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Qualcomm® SA8775P | 1.708 ms | 0 - 72 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Qualcomm® SA8775P | 1.708 ms | 0 - 72 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Qualcomm® SA8775P | 1.708 ms | 0 - 72 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Snapdragon® 7 Gen 4 Mobile | 1.618 ms | 0 - 79 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Qualcomm® QCM6690 | 10.62 ms | 0 - 199 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Qualcomm® QCS9075 | 1.617 ms | 0 - 2 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Snapdragon® 8 Elite For Galaxy Mobile | 0.671 ms | 0 - 69 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Qualcomm® QCS8450 (Proxy) | 1.864 ms | 0 - 109 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Qualcomm® SA7255P | 3.27 ms | 0 - 72 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Qualcomm® SA8295P | 2.196 ms | 0 - 69 MB | NPU
| HRNetFace | QNN_DLC | w8a8 | Snapdragon® 7 Gen 4 Mobile | 1.618 ms | 0 - 79 MB | NPU
| HRNetFace | TFLITE | float | Snapdragon® 8 Elite Gen 5 Mobile | 1.377 ms | 0 - 96 MB | NPU
| HRNetFace | TFLITE | float | Snapdragon® 8 Elite Mobile | 1.759 ms | 0 - 94 MB | NPU
| HRNetFace | TFLITE | float | Snapdragon® 8 Gen 3 Mobile | 2.333 ms | 0 - 138 MB | NPU
| HRNetFace | TFLITE | float | Qualcomm® QCS8550 (Proxy) | 3.315 ms | 0 - 2 MB | NPU
| HRNetFace | TFLITE | float | Qualcomm® SA8775P | 5.127 ms | 1 - 92 MB | NPU
| HRNetFace | TFLITE | float | Qualcomm® SA8775P | 5.127 ms | 1 - 92 MB | NPU
| HRNetFace | TFLITE | float | Qualcomm® SA8775P | 5.127 ms | 1 - 92 MB | NPU
| HRNetFace | TFLITE | float | Qualcomm® SA7255P | 15.48 ms | 0 - 92 MB | NPU
| HRNetFace | TFLITE | float | Qualcomm® QCS8450 (Proxy) | 5.498 ms | 0 - 125 MB | NPU
| HRNetFace | TFLITE | float | Qualcomm® SA8295P | 5.669 ms | 0 - 74 MB | NPU
| HRNetFace | TFLITE | float | Snapdragon® 8 Elite For Galaxy Mobile | 1.759 ms | 0 - 94 MB | NPU
| HRNetFace | TFLITE | float | Qualcomm® QCS9075 | 5.057 ms | 0 - 35 MB | NPU
| HRNetFace | TFLITE | w8a8 | Snapdragon® 8 Elite Gen 5 Mobile | 0.456 ms | 0 - 75 MB | NPU
| HRNetFace | TFLITE | w8a8 | Snapdragon® 8 Elite Mobile | 0.58 ms | 0 - 72 MB | NPU
| HRNetFace | TFLITE | w8a8 | Snapdragon® 8 Gen 3 Mobile | 0.731 ms | 0 - 113 MB | NPU
| HRNetFace | TFLITE | w8a8 | Qualcomm® QCS6490 | 3.35 ms | 0 - 18 MB | NPU
| HRNetFace | TFLITE | w8a8 | Qualcomm® QCS8550 (Proxy) | 1.097 ms | 0 - 2 MB | NPU
| HRNetFace | TFLITE | w8a8 | Qualcomm® SA8775P | 1.499 ms | 0 - 75 MB | NPU
| HRNetFace | TFLITE | w8a8 | Qualcomm® SA8775P | 1.499 ms | 0 - 75 MB | NPU
| HRNetFace | TFLITE | w8a8 | Qualcomm® SA8775P | 1.499 ms | 0 - 75 MB | NPU
| HRNetFace | TFLITE | w8a8 | Snapdragon® 7 Gen 4 Mobile | 1.357 ms | 0 - 75 MB | NPU
| HRNetFace | TFLITE | w8a8 | Qualcomm® QCM6690 | 9.847 ms | 0 - 192 MB | NPU
| HRNetFace | TFLITE | w8a8 | Qualcomm® QCS9075 | 1.305 ms | 0 - 18 MB | NPU
| HRNetFace | TFLITE | w8a8 | Snapdragon® 8 Elite For Galaxy Mobile | 0.58 ms | 0 - 72 MB | NPU
| HRNetFace | TFLITE | w8a8 | Qualcomm® QCS8450 (Proxy) | 1.563 ms | 0 - 112 MB | NPU
| HRNetFace | TFLITE | w8a8 | Qualcomm® SA7255P | 2.888 ms | 0 - 72 MB | NPU
| HRNetFace | TFLITE | w8a8 | Qualcomm® SA8295P | 1.985 ms | 0 - 69 MB | NPU
| HRNetFace | TFLITE | w8a8 | Snapdragon® 7 Gen 4 Mobile | 1.357 ms | 0 - 75 MB | NPU

## License
* The license for the original implementation of HRNetFace can be found
  [here](https://github.com/HRNet/HRNet-Facial-Landmark-Detection/blob/master/LICENCE).

## References
* [Deep High-Resolution Representation Learning for Visual Recognition](https://arxiv.org/abs/1908.07919)
* [Source Model Implementation](https://github.com/HRNet/HRNet-Facial-Landmark-Detection)

## Community
* Join [our AI Hub Slack community](https://aihub.qualcomm.com/community/slack) to collaborate, post questions and learn more about on-device AI.
* For questions or feedback please [reach out to us](mailto:ai-hub-support@qti.qualcomm.com).