sherpa-onnx Gradle Example

This directory demonstrates how to use sherpa-onnx via Gradle.

Prerequisites

• JDK 8 or above
• Gradle 8.x (or use the included Gradle wrapper)

Dependencies

The project uses JitPack to fetch sherpa-onnx artifacts. There are two ways to declare the dependencies.

Approach 1: Simple (single dependency)

This is the easiest way — one dependency pulls in everything:

repositories {
    mavenCentral()
    maven { url 'https://jitpack.io' }
}

dependencies {
    implementation 'com.github.k2-fsa:sherpa-onnx:1.13.5'
}

Approach 2: Multi-module (recommended)

This is the recommended way for production use. It splits the JVM API and native libs so you only ship the platform you need, keeping the final jar lightweight:

repositories {
    mavenCentral()
    maven { url 'https://jitpack.io' }
}

dependencies {
    // 1. JVM core API
    implementation 'com.github.k2-fsa.sherpa-onnx:sherpa-onnx-jvm:1.13.5'

    // 2. Platform native lib — pick ONE for your target platform
    implementation 'com.github.k2-fsa.sherpa-onnx:sherpa-onnx-native-lib-osx-aarch64:1.13.5'
}

Available native lib artifacts for each platform:

Note: The build.gradle in this directory uses Approach 2 by default. Approach 1 is included as a comment for reference.

Build

cd java-api-examples/gradle-examples

# Using Gradle wrapper (recommended)
./gradlew build

# Or using system Gradle
gradle build

Run

# Using Gradle wrapper (recommended)
./gradlew run

# Or using system Gradle
gradle run

Expected output:

sherpa-onnx version: x.y.z
sherpa-onnx gitSha1: ...
sherpa-onnx gitDate: ...

Appendix: Approach 1 vs Approach 2 comparison (advanced)

The two approaches produce very different fat jars:

Why Approach 2 is recommended

Approach 2 is ~10x smaller (~9 MB vs ~95 MB) because it only ships the native libs for your target platform. This matters for:

• Download size: users only download what they need
• Startup time: the JVM loads fewer native libraries
• Disk space: especially important for CI/CD and container images

Verify it yourself

# Build and check the jar
./gradlew build
ls -lh build/libs/*.jar

# List native libs in the jar
unzip -l build/libs/sherpa-onnx-gradle-example.jar | grep -E "\.so$|\.dylib$|\.dll$"