Skip to content

README.md

Latest commit

 

History

History
91 lines (63 loc) · 2.88 KB

README.md

File metadata and controls

91 lines (63 loc) · 2.88 KB
Raw

Qualcomm® AI Hub Apps

GenieX Demo

On-device AI chat application for Android on Snapdragon® powered by the GenieX SDK. Runs Large Language Models (LLMs) and Vision-Language Models (VLMs) on the Snapdragon® Neural Processing Unit (NPU), GPU, or CPU through a single pluggable runtime.

Unlike most AI Hub apps, the model weights are not bundled into the APK. The app downloads the model you select at runtime from an in-app catalog, so no model export or asset copying is required to build and run it.

We recommend using a device from QDC for this demo.

Get the App

Option A: Using the CLI (Recommended)

Install the CLI and fetch the app source:

pip install qai-hub-apps
qai-hub-apps fetch geniex_chat_android --output-dir ~
cd ~/geniex_chat_android

Note

--model is not required for this app. GenieX downloads the model you pick from the in-app catalog at runtime, so no model binaries need to be placed in the project before building.

Option B: Cloning the Repo

If you cloned the repository, the app directory under apps/geniex_chat_android is already self-contained — there are no model weights to fetch separately.

Prerequisites

  1. Download Android Studio. Version 2024.3.1 or newer is required.
  2. Enable USB debugging on your Android device.

The GenieX Android binding is consumed from Maven Central as com.qualcomm.qti:geniex-android (version pinned in build.gradle). Gradle resolves it automatically on first sync — no separate SDK download is required.

Build the APK

  1. Open this folder in Android Studio.

  2. Run Gradle sync.

  3. Build the app target (Build → Build Bundle(s) / APK(s) → Build APK(s)).

  4. The APK is written to:

    build/outputs/apk/{build_type}/app-{build_type}.apk

Run on Device

  1. Install the APK via adb:

    adb install -t build/outputs/apk/debug/app-debug.apk

  2. Launch the app from the device's launcher. Models are downloaded on first use; pick one from the in-app catalog.

Supported Hardware

  • NPU: Qualcomm® Snapdragon® 8 Elite, Snapdragon® 8 Elite Gen 5
  • GPU: Qualcomm® Adreno™ GPU
  • CPU: ARM64-v8a

Technologies Used by this App

License

This app is released under the BSD-3 License found at the root of this repository.

The GenieX SDK dependency is released under its own license. Refer to the GenieX repository for details.