sdk/runanywhere-kotlin/modules/runanywhere-core-qhexrt/README.md
Optional Qualcomm Hexagon NPU backend for the RunAnywhere Kotlin SDK — on-device LLM, VLM, STT, TTS, embeddings, and diffusion routed to Snapdragon Hexagon V75/V79/V81 NPUs. Android arm64-v8a only.
The AAR is binary-only: it bundles the QHexRT engine, JNI bridge, redistributable Qualcomm QAIRT/QNN host libraries, and Hexagon DSP skels. Model conversion / CoreML / forge tooling is not included — download models at runtime through the SDK catalog.
Requires the core SDK. Add both to your app module's build.gradle.kts:
dependencies {
implementation("io.github.sanchitmonga22:runanywhere-sdk:0.20.11")
implementation("io.github.sanchitmonga22:runanywhere-qhexrt-android:0.20.11")
}
Probe capability, register once at startup, then use standard RunAnywhere APIs — the SDK routes supported models to the NPU:
import com.runanywhere.sdk.npu.qhexrt.QHexRT
import com.runanywhere.sdk.public.RunAnywhere
val npu = QHexRT.probeNpu() // safe on any device
if (npu.qhexrt_supported) {
QHexRT.register() // also installs DSP skels from AAR assets
}
RunAnywhere.initialize(context = this, /* ... */)
// Register, download, load, and infer via core APIs
See the Kotlin SDK README for full setup.
| Primitive | Examples |
|---|---|
| LLM text generation | LFM2.5, Cosmos3-Edge text |
| VLM | Cosmos3-Edge VLM |
| STT / ASR | Whisper, Parakeet, Canary, Moonshine |
| TTS | Magpie, Kokoro, Kitten, Melo |
| Embeddings | Nemotron Embed, EmbeddingGemma |
| Diffusion | Cosmos3-Edge / LaMa inpaint |
Exact catalog rows and Hexagon arch support are returned by the runtime model catalog after QHexRT.register().
arm64-v8a only (no armeabi-v7a / x86_64 package)runanywhere-sdk:0.20.11librac_backend_qhexrt.so + librac_backend_qhexrt_jni.solibQnnHtp*.so, libQnnSystem.so, …)QHexRTSkelInstaller)META-INF/THIRD-PARTY-NOTICES-QAIRT.txt (Qualcomm redistributable notice)META-INF/LICENSE.runanywhere-qhexrt.txtProprietary RunAnywhere License for the engine binaries — see LICENSE.
Qualcomm QAIRT runtime libraries remain under Qualcomm's SDK redistribution terms — see META-INF/THIRD-PARTY-NOTICES-QAIRT.txt inside the AAR.