Instructions to use litert-community/PlantNet-300K-ResNet18-LiteRT with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- LiteRT
How to use litert-community/PlantNet-300K-ResNet18-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
PlantNet-300K ResNet18 β LiteRT (plant species ID, GPU)
On-device fine-grained plant species identification β 1081 species β running
fully on the LiteRT CompiledModel GPU delegate (no CPU fallback). A
PlantNet-300K (NeurIPS 2021) ResNet18.
~16 ms/frame on a Pixel 8a.
- Architecture: torchvision ResNet18 (pure CNN).
- Weights: cpoisson/plantnet300k-resnet18 Β· Apache-2.0.
- Classes: 1081 plant species (Latin names).
- Size: 47 MB.
I/O
- Input:
[1, 3, 224, 224]NCHW, RGB, ImageNet-normalized (mean[0.485,0.456,0.406], std[0.229,0.224,0.225]; center-crop then resize 224). - Output:
[1, 1081]species logits β softmax + top-k for the predicted species.
Labels: class index i maps to the i-th species when the PlantNet-300K
species-id strings are sorted (torchvision ImageFolder order); names from
plantnet300K_species_id_2_name.json.
GPU conversion
Plain torchvision ResNet18 β a pure CNN. It converts to a fully GPU-compatible graph
(37/37 nodes on the delegate, 1 partition; device corr 0.99999, top-1 match) with
one patch: the ResNet stem MaxPool2d(padding=1) lowers to a PADV2 with -inf
padding (PADV2: src has wrong size on the Mali delegate), replaced by an explicit
0-pad + unpadded maxpool β exact, since the maxpool input is post-ReLU (β₯ 0).
CPU-exact vs PyTorch (corr 0.99999999999).
Minimal usage
Kotlin (Android, LiteRT CompiledModel GPU)
val options = CompiledModel.Options(Accelerator.GPU)
val model = CompiledModel.create(context.assets, "plantnet.tflite", options, null)
val inBufs = model.createInputBuffers()
val outBufs = model.createOutputBuffers()
inBufs[0].writeFloat(inputNCHW) // [1,3,224,224], RGB, ImageNet-norm
model.run(inBufs, outBufs)
val logits = outBufs[0].readFloat() // [1081]
val top = logits.indices.sortedByDescending { logits[it] }.take(5) // species indices
Python (LiteRT / ai-edge-litert)
from ai_edge_litert.interpreter import Interpreter
import numpy as np
it = Interpreter(model_path="plantnet.tflite"); it.allocate_tensors()
inp, out = it.get_input_details(), it.get_output_details()
it.set_tensor(inp[0]["index"], x) # [1,3,224,224] float32, ImageNet-norm
it.invoke()
logits = it.get_tensor(out[0]["index"])[0] # [1081]
top5 = logits.argsort()[::-1][:5]
Conversion
Converted with litert-torch (build_plantnet.py): loads the Apache-2.0 ResNet18
weights, applies the ZeroPadMaxPool patch, and exports.
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 | 37 / 37 | ~16 ms |
TFLite benchmark_model (TfLiteGpuDelegateV2) |
GPU (OpenCL) | 37 / 37 | 19.9 ms |
TFLite benchmark_model |
CPU (XNNPACK, 4 threads) | β | 61.8 ms |
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.
Snapdragon NPU (Hexagon)
This file runs on the Qualcomm Hexagon NPU as published β no conversion and no pre-compiled artifact. LiteRT compiles it on the device and caches the result.
Measured on a physical Samsung Galaxy S26 (Snapdragon 8 Elite Gen 5 / SM8850,
Hexagon v81) with LiteRT CompiledModel 2.2.0 β 5 warm-up runs then 50 timed runs, one
accelerator per process, every row taken at device thermal status NONE.
| Compute unit | Inference (median / min) | Load | Start headroom |
|---|---|---|---|
| NPU (Hexagon) β first launch | 0.90 ms / 0.88 ms | 586 ms | 0.59 |
| NPU (Hexagon) β cached | 0.90 ms / 0.89 ms | 110 ms | 0.59 |
| GPU (Adreno) | 3.49 ms / 3.17 ms | 464 ms | 0.59 |
The NPU is 3.9x faster on inference here (0.90 ms against 3.49 ms). The first launch pays once for on-device compilation; every launch after that loads in 110 ms against 464 ms for the GPU (4.2x), because the GPU rebuilds its shaders each time. The file is fp16 and needs no int8 quantization to reach the NPU.
Running it on the NPU
Put these in jniLibs/arm64-v8a/. None of them are distributed from this repository β
the first two come from Google, the rest from Qualcomm's own SDK:
| Library | Source |
|---|---|
libLiteRtDispatch_Qualcomm.so, libLiteRtCompilerPlugin_Qualcomm.so |
litert_npu_runtime_libraries_jit.zip, a release asset of google-ai-edge/LiteRT |
libQnnHtp.so, libQnnSystem.so, libQnnHtpV81Stub.so, libQnnHtpV81Skel.so, libQnnHtpPrepare.so, libQnnIr.so, libQnnSaver.so |
Qualcomm QAIRT β the same zip ships fetch_qualcomm_library.sh, which downloads the SDK and copies them for you |
Pick the runtime matching the device's Hexagon version: SM8550 β v73, SM8650 β v75, SM8750 β v79, SM8850 β v81.
val env = Environment.create(
context,
mapOf(
Environment.Option.DispatchLibraryDir to context.applicationInfo.nativeLibraryDir,
// Required for on-device compilation. Without it the model silently runs on CPU.
Environment.Option.CompilerPluginLibraryDir to context.applicationInfo.nativeLibraryDir,
),
)
val options = CompiledModel.Options(Accelerator.NPU).apply {
qualcommOptions = CompiledModel.QualcommOptions(
htpPerformanceMode = CompiledModel.QualcommOptions.HtpPerformanceMode.BURST
)
}
val model = CompiledModel.create(context.assets, "plantnet.tflite", options, env)
Build settings: useLegacyPackaging = true under packaging { jniLibs { β¦ } }, so the
DSP can open the skel from a real path, and Kotlin 2.3+ for LiteRT 2.2.0's metadata.
Every NPU failure here is silent. There is no error when the NPU is unavailable β you get a plausible CPU number instead. Confirm from logcat which delegate took the graph:
Replacing 1 out of 1 node(s) with delegate (DispatchDelegate)is the NPU, while... (TfLiteXNNPackDelegate)is the CPU. A missing library is reported only as aW-leveldlopen failedline under a genericNo compiler plugin foundsummary.
On the conditions. Thermal headroom is reported as measured, where 1.0 is the
throttling threshold. All rows were taken at a comparable headroom and compare directly;
figures taken at a different headroom will differ. Each accelerator ran in its own
process, because LiteRT's Environment is shared within one and the first model load
fixes the options for every later one.
License
Apache-2.0 (weights: cpoisson/plantnet300k-resnet18). PlantNet-300K code: BSD-2-Clause (plantnet/PlantNet-300K, NeurIPS 2021).
- Downloads last month
- 56
