Kindly Android SDK

The Kindly Chat SDK for Android allows you to integrate a fully-featured customer support chat into your Android application. The SDK provides a native Jetpack Compose chat interface with real-time messaging, push notifications, custom theming, and more.

!!! tip "Agent-Assisted Setup"

Point your AI coding assistant at the skill file below and it will install, initialize, and wire up Kindly for you automatically.

**Prompt to copy:**

```text
Use curl to download, read and follow: https://kindly-ai.github.io/sdk-chat-android-sources/SKILL.md
```

Requirements

Requirement	Minimum Version
Android minSdk	API 21 (Android 5.0)
compileSdk	35
Kotlin	2.0
Jetpack Compose	Enabled (buildFeatures { compose = true })
Java	1.8+ (source and target compatibility)

!!! note Starting with SDK version 1.0.88, the SDK is compiled with Kotlin 2.x. Projects using Kotlin 1.x must upgrade to Kotlin 2.0 or higher to consume the SDK.

Installation

Option A: Maven Central (Recommended)

Add the dependency directly — no extra repository needed:

dependencies {
    implementation("ai.kindly:sdk:1.0.94")
}

Find the latest version on Maven Central.

Option B: JitPack

Add the JitPack repository to your settings.gradle:

// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        maven(url = "https://jitpack.io")
    }
}

Then add the dependency:

dependencies {
    implementation("com.github.kindly-ai:sdk-chat-android:1.0.94")
}

Find the latest version on JitPack.

Quick Start

// Initialize in your Application class
KindlySDK.start(
    application = this,
    botKey = "YOUR_BOT_KEY",
    languageCode = "en",
    market = "YOUR_MARKET"
)

// Display the chat from any Activity/Fragment
KindlySDK.launchChat(context = context)