Instructions to use litert-community/HSEmotion-B0-LiteRT with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- LiteRT
How to use litert-community/HSEmotion-B0-LiteRT with LiteRT:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
HSEmotion (EfficientNet-B0) β facial emotion recognition on LiteRT GPU
Recognize the 8 AffectNet emotions β anger, contempt, disgust, fear, happiness,
neutral, sadness, surprise β from a cropped face, with the whole network running on
the LiteRT CompiledModel GPU delegate (no CPU fallback).
HSEmotion (EmotiEffLib,
Apache-2.0) is an EfficientNet-B0 fine-tuned on AffectNet.
- Architecture: EfficientNet-B0 (
tf_efficientnet_b0), 224Γ224, 8-way head. - Weights: av-savchenko/face-emotion-recognition
enet_b0_8_best_afew.ptΒ· Apache-2.0. - Size: 8 MB (fp16).
Detected face + emotion distribution on a Pixel 8a; the classifier runs on the GPU.
I/O
- Input:
[1, 3, 224, 224]NCHW, RGB, ImageNet-normalized (a cropped face). - Output:
[1, 8]logits, index order:anger, contempt, disgust, fear, happiness, neutral, sadness, surprise.
GPU conversion
Two hurdles, both fixed in build_hsemotion.py:
- Old-timm pickle. The released weights are a pickled model built with an old
timm whose forward is broken under current timm (missing
conv_s2d). The state dict is lifted into a fresh timmtf_efficientnet_b0(num_classes=8, remappingclassifier.0.*βclassifier.*), which has a working forward β 358/360 tensors match by name and shape, the rest is the remapped classifier. - fp16 SqueezeExcite mean β NaN. βThe SE block's global mean
x.mean((2,3))over the 112Γ112 stem map is a single fp16 reduction whose partial sum overflows 65504 β the GPU delegate emits an all-NaN output (it computes the reduction in fp16 even for an fp32 graph; desktop fp16 CPU is exact). Replaced by a hierarchical mean β repeatedavg_pool2dover equal-size tiling windows (β€ 49 elements each) β mathematically identical but fp16-safe.
Pixel 8a: 342/342 nodes on the GPU delegate, 1 partition, ~2 ms/inference (fp16). Device fp16 top-1 matches desktop fp32 (logits corr 0.99997); desktop fp16 CPU corr vs PyTorch is 1.0.
Minimal usage
Kotlin (Android, LiteRT CompiledModel GPU)
val model = CompiledModel.create(context.assets, "hsemotion_b0_fp16.tflite",
CompiledModel.Options(Accelerator.GPU), null)
val inputs = model.createInputBuffers()
val outputs = model.createOutputBuffers()
inputs[0].writeFloat(faceNchw) // [1,3,224,224] cropped face, ImageNet-normalized
model.run(inputs, outputs)
val logits = outputs[0].readFloat() // [8] -> softmax + argmax
Python (LiteRT CompiledModel API)
import numpy as np
from ai_edge_litert.compiled_model import CompiledModel
model = CompiledModel.from_file("hsemotion_b0_fp16.tflite")
inputs = model.create_input_buffers(0)
outputs = model.create_output_buffers(0)
inputs[0].write(np.ascontiguousarray(face, np.float32)) # [1,3,224,224]
model.run_by_index(0, inputs, outputs)
logits = outputs[0].read(8, np.float32) # argmax -> emotion
The model expects a tightly cropped face (use any face detector; the Android
sample uses the built-in android.media.FaceDetector).
Performance
Measured on a Pixel 8a (Tensor G3, Android 16) with the standard TFLite benchmark_model tool β 10 warm-up runs then 50 timed runs, reported as the tool's mean.
| Runtime | Backend | Graph on GPU | Latency |
|---|---|---|---|
LiteRT CompiledModel (LITERT_CL) |
GPU | 342 / 342 | ~2 ms |
TFLite benchmark_model (TfLiteGpuDelegateV2) |
GPU (OpenCL) | 342 / 342 | 13.1 ms |
TFLite benchmark_model |
CPU (XNNPACK, 4 threads) | β | XNNPACK declined the graph |
The two GPU rows are different runtimes, not a contradiction. The LITERT_CL figure is the one recorded when this model shipped, taken through LiteRT's own CompiledModel accelerator β the path the Kotlin sample app and the LiteRT API use. The TfLiteGpuDelegateV2 figure is the classic TFLite OpenCL delegate, measured with a tool anyone can download and re-run. They agree on how much of the graph the GPU takes; they disagree on speed, and the classic delegate is the slower of the two here. Read the TfLiteGpuDelegateV2 row as a reproducible floor, not as this model's speed on LiteRT.
XNNPACK declines these fp16 graphs β it reports failed to delegate DEPTHWISE_CONV_2D and then fails to allocate tensors β so there is no usable CPU number. Disabling XNNPACK falls back to reference kernels, which measured about 20Γ slower than the GPU on models of this size and would not represent CPU inference anyone would ship.
Snapdragon NPU (Hexagon)
The NPU is 2.02x faster than the GPU (0.823 ms against 1.67 ms) and loads 5.86x faster (108 ms against 634 ms).
| backend | inference (median / min) | load |
|---|---|---|
| NPU (Hexagon v81) | 0.823 ms / 0.803 ms | 108 ms |
| GPU (Adreno) | 1.67 ms / 1.52 ms | 634 ms |
Measured on a Samsung Galaxy S26 (Snapdragon 8 Elite Gen 5 / SM8850, Hexagon v81, Android 16), LiteRT CompiledModel 2.2.0, one accelerator per process, 5 warm-up runs then N=50 timed runs, median reported. Every run held thermal status NONE throughout. Headroom 0.69-0.70, where 1.0 is the throttling threshold.
The NPU rows here ran artifacts compiled ahead of time for SM8850 with QAIRT 2.47.0; the GPU rows ran the published files as they are. LiteRT can also compile for the NPU on the device at first load, which is what lets you ship the published file unchanged β that path and the ten runtime libraries it needs are in the NPU recipe, and we did not measure it here. GPU wiring is in the GPU recipe.
License
Apache-2.0 (HSEmotion / EmotiEffLib). Converted with litert-torch.
- Downloads last month
- 49
