Kotlin

// build.gradle.kts
dependencies {
    implementation("ai.synheart:syni:0.0.3")
}

curl -fsSL https://synheart.sh/install | sh
synheart install runtime syni

// app/build.gradle.kts
android {
    sourceSets {
        getByName("main").jniLibs.srcDirs(
            file("${rootProject.projectDir}/synheart/vendor/syni/android/jniLibs"),
        )
    }
}

import ai.synheart.syni.SyniAgent
import ai.synheart.syni.SyniModels
import ai.synheart.syni.SyniSpecPersona

val agent = SyniAgent(context = application)

// Load a persona by id from bundled spec assets.
val persona = SyniSpecPersona.load(context, "focus.coach.v1")

// First-run install: download + verify the model, load the engine,
// bind the persona. Emits lifecycle events on agent.installState.
agent.install(
    persona = persona,
    model = SyniModels.qwen25_15bInstructQ4,
)

// Single-turn chat.
val response = agent.chat("How can I focus right now?")
println(response.displayText)

agent.chatStream("hello").collect { event ->
    when (event) {
        is SyniChatEvent.Delta -> print(event.delta)
        is SyniChatEvent.Final -> println("\n[${event.response.displayText.length} chars]")
    }
}

val agent = SyniAgent(
    context = application,
    cloudConfig = SyniCloudConfig(
        baseUrl = "https://api.synheart.ai",
        authToken = { "<bearer-token>" },
        tenantId = "<tenant>",
        userId = "<user>",
    ),
)

agent.chat(
    message = "how was my recent session?",
    mode = SyniExecutionMode.CLOUD_FIRST, // try cloud, fall back to local
)

agent.installState.collect { state ->
    when (state) {
        SyniInstallState.NotInstalled -> showInstallPrompt()
        is SyniInstallState.Installing -> showProgress(state.stage, state.progress)
        is SyniInstallState.Installed -> showReady()
        is SyniInstallState.Failed -> showError(state.reason)
    }
}