Instructions to use litert-community/xfeat-litert with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- LiteRT
How to use litert-community/xfeat-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
XFeat (Accelerated Features) β LiteRT (CompiledModel GPU)
XFeat (Apache-2.0, ~1.5M, a lightweight pure-CNN local feature extractor for image matching β
SLAM / AR / image registration) re-authored to a GPU-native LiteRT .tflite via litert_torch.
FP16, 1.4 MB, input [1, 480, 640, 1] NHWC normalized grayscale.
167 mutual-nearest-neighbor matches between two views of the same scene, from the on-device fp16 model. Photo: "Lily the Golden Retriever in the grass" (Wikimedia Commons, Public Domain); second view is a synthetic homography (rotation + translation).
Verified on a Pixel 8a: full LITERT_CL residency (72/72 nodes, 1 partition), ~0.4 ms, GPU output matches CPU/PyTorch (corr 0.9999).
I/O
- Input
[1, 480, 640, 1]NHWC, grayscale, per-image InstanceNorm applied host-side ((g - mean)/sqrt(var+1e-5)over the image). - Outputs (all at H/8 Γ W/8 = 60Γ80):
feats[1,64,60,80]dense descriptors;keypoints[1,65,60,80]keypoint logits;heatmap[1,1,60,80]reliability. Keypoint NMS, descriptor bilinear-sampling, and mutual-nearest-neighbor matching run host-side.
Minimal usage
import numpy as np
from PIL import Image
from ai_edge_litert.interpreter import Interpreter
def extract(path):
g = np.asarray(Image.open(path).convert("L").resize((640, 480)), np.float32)
g = (g - g.mean()) / np.sqrt(g.var() + 1e-5) # host instance-norm
it = Interpreter(model_path="xfeat_fp16.tflite"); it.allocate_tensors()
it.set_tensor(it.get_input_details()[0]["index"], g[None, None]); it.invoke()
feats, heat, klog = (it.get_tensor(o["index"])[0] for o in
sorted(it.get_output_details(), key=lambda o: o["index"]))
return feats, heat, klog # [64,60,80], [1,60,80], [65,60,80]
# decode: per-cell softmax over the 65 logits (64 positions + dustbin) * reliability,
# 5x5 NMS + top-K, bilinear-sample feats at kp/8, L2-normalize, mutual-NN (cos >= 0.82)
Kotlin (Android, LiteRT CompiledModel GPU)
// implementation("com.google.ai.edge.litert:litert:2.1.5")
val model = CompiledModel.create(File(ctx.filesDir, "xfeat_fp16.tflite").absolutePath,
CompiledModel.Options(Accelerator.GPU), null)
val inBuf = model.createInputBuffers(); val outBuf = model.createOutputBuffers()
inBuf[0].writeFloat(grayNorm) // [1,1,480,640] instance-normalized grayscale
model.run(inBuf, outBuf)
val feats = outBuf[0].readFloat() // [64*60*80] dense descriptors
val heat = outBuf[1].readFloat() // [60*80] reliability
val klog = outBuf[2].readFloat() // [65*60*80] cell logits
// decode + mutual-NN matching: see XFeatMatcher.kt in the image_matching LiteRT sample.
GPU-clean re-authoring
- Input gray + InstanceNorm moved host-side (its spatial reduction over HΒ·W would overflow fp16 on the delegate).
_unfold2d(x, 8)(space-to-depth via unfold β >4-D / GATHER_ND) β a one-hotConv2d(1,64,k=8,s=8)(exact, single CONV_2D). Result: zero GATHER/SELECT/TopK/Cast, no >4-D β full GPU residency.
Training data & PII
XFeat is trained on public correspondence data (MegaDepth + synthetic homographies). It outputs geometric keypoints/descriptors only β no faces, identities, or personal attributes. Official weights; only the op graph was re-authored for GPU.
Sample app + conversion script
https://github.com/google-ai-edge/litert-samples (compiled_model_api, two-image matching).
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 |
|---|---|---|---|
TFLite benchmark_model (TfLiteGpuDelegateV2) β xfeat.tflite |
GPU (OpenCL) | 72 / 72 | 22.8 ms |
TFLite benchmark_model (TfLiteGpuDelegateV2) β xfeat_fp16.tflite |
GPU (OpenCL) | 73 / 73 | 24.1 ms |
TFLite benchmark_model β xfeat.tflite |
CPU (XNNPACK, 4 threads) | β | XNNPACK declined the graph |
TFLite benchmark_model β xfeat_fp16.tflite |
CPU (XNNPACK, 4 threads) | β | XNNPACK declined the graph |
Any on-device figure recorded when this model shipped came from a different runtime. It was taken through LiteRT's own CompiledModel accelerator (logcat reports it as LITERT_CL), which is the path the Kotlin sample app and the LiteRT API use, and it appears elsewhere on this card. The rows above are the classic TFLite OpenCL delegate, measured with a tool anyone can download and re-run. The two are not comparable, so read the rows above as a reproducible floor rather than 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)
xfeat.tfliteβ the GPU is faster: 4.13 ms against 607.5 ms on the NPU, a factor of 147. The NPU still loads 6.30x faster (98 ms against 620 ms).xfeat_fp16.tfliteβ the GPU is faster: 4.31 ms against 384.5 ms on the NPU, a factor of 89. The NPU still loads 6.37x faster (100 ms against 640 ms).
| file | backend | compiled | inference (median / min) | load |
|---|---|---|---|---|
xfeat.tflite |
NPU (Hexagon v81) | on-device JIT | 607.5 ms / 589.1 ms | 98 ms |
xfeat.tflite |
GPU (Adreno) | β | 4.13 ms / 2.32 ms | 620 ms |
xfeat_fp16.tflite |
NPU (Hexagon v81) | on-device JIT | 384.5 ms / 369.8 ms | 100 ms |
xfeat_fp16.tflite |
GPU (Adreno) | β | 4.31 ms / 3.04 ms | 640 ms |
Measured on a Samsung Galaxy S26 (Snapdragon 8 Elite Gen 5 / SM8850, Hexagon v81, Android 16) with 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.68β0.69, where 1.0 is the throttling threshold.
The NPU rows ran the published file unchanged. LiteRT compiled it for the Hexagon on the device at first load. Those first compiles took 729 ms to 774 ms here. The load column above is the cached load every later run pays. Recipe and the runtime libraries it needs: NPU guide.
GPU wiring: GPU guide.
- Downloads last month
- 80
