Back to Nexa Sdk

Android Install

docs/en/run/android/install.mdx

0.3.162.5 KB
Original Source

import Feedback from "/snippets/page-feedback.mdx";

Add the GenieX SDK to an Android Studio project so your app can pull weights from Hugging Face / Qualcomm AI Hub and run them on the Hexagon NPU, Adreno GPU, or CPU compute units — all in Kotlin.

Try the sample app first

See GenieX running on Android before you write any code. The reference chat app — with model picker, resumable downloads, and VLM support — lives in qualcomm/ai-hub-apps. Clone it, open it in Android Studio, and hit Run ▶.

<Card title="Get the GenieX Chat sample app" icon="github" href="https://github.com/qualcomm/ai-hub-apps/blob/release/geniex_chat_android/README.md"> Build the reference chat app from source — follow the README to clone, build, and run it. </Card>

Pick a model from the dropdown and choose NPU, GPU, or CPU on load. Tap the image button for VLMs. Stay on Wi-Fi for the first download.

No phone? See Testing without a physical device.

Prerequisites

  • Android Studio Hedgehog (2023.1.1) or newer.
  • minSdk = 27 (Android 8.1) in your app module.
  • A phone running Snapdragon 8 Elite (SM8750) or Snapdragon 8 Elite Gen 5 (SM8850) — see Supported platforms.

Add the SDK to your app

<Steps> <Step title="Enable Maven Central"> In `settings.gradle.kts` (or your top-level `build.gradle.kts` for older projects):
```kotlin
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}
```
</Step> <Step title="Add the dependency"> In your **app module**'s `build.gradle.kts`:
```kotlin
dependencies {
    implementation("com.qualcomm.qti:geniex-android:0.3.1")
}
```

The artifact ships native `arm64-v8a` libraries — no NDK or CMake on your side.
</Step> <Step title="Declare permissions"> The SDK pulls weights at runtime. In `AndroidManifest.xml`:
```xml
<uses-permission android:name="android.permission.INTERNET" />
```

For VLMs that load images from the gallery, also declare `READ_EXTERNAL_STORAGE` (or scoped media permissions on Android 13+).
</Step> <Step title="Sync Gradle"> Click **Sync Now** in Android Studio. </Step> </Steps>

Next, head to the Quickstart to download and run your first model.

<Feedback/>