---
title: Kindly Android SDK
slug: kindly-android-sdk
docTags: 
createdAt: 2026-09-14T23:57:45.121Z
---

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"

````javascript
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:

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

Find the latest version on [Maven Central](https://central.sonatype.com/artifact/ai.kindly/sdk).

### Option B: JitPack

Add the JitPack repository to your `settings.gradle`:

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

Then add the dependency:

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

Find the latest version on [JitPack](https://jitpack.io/#kindly-ai/sdk-chat-android).

## Quick Start

```kotlin
// 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)
```