---
title: Android SDK
slug: sdk/android-sdk
createdAt: 2026-11-04T11:39:55.219Z
---

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.

:::hint{type="success"}
**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://docs.kindly.ai/sdk/android-sdk-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)       |

:::hint{type="info"}
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:2.0.18")
}
```

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:2.0.18")
}
```

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

## Documentation

- **Getting Started**
  Set up the SDK and configure it for your app
  [Initialization](https://docs.kindly.ai/sdk/android-sdk-initialization) [Configuration](https://docs.kindly.ai/sdk/android-sdk-config)
- **Chat Lifecycle**
  Control how the chat UI is displayed and managed
  [Launch Chat](https://docs.kindly.ai/sdk/android-sdk-launch-chat) [Close Chat](https://docs.kindly.ai/sdk/android-sdk-close-chat) [End Chat](https://docs.kindly.ai/sdk/android-sdk-end-chat) [Kill SDK](https://docs.kindly.ai/sdk/android-sdk-kill-sdk)
- **Features**
  Events, authentication, context, dialogues, and notifications
  [Events](https://docs.kindly.ai/sdk/android-sdk-events) [Authentication](https://docs.kindly.ai/sdk/android-sdk-authentication) [Notifications](https://docs.kindly.ai/sdk/android-sdk-notification-support)
- **Customization**
  Theme the chat UI, handle links, and set up deep linking
  [Custom Theming](https://docs.kindly.ai/sdk/android-sdk-custom-theming) [URL Schemes](https://docs.kindly.ai/sdk/android-sdk-url-schemes) [Link Interception](https://docs.kindly.ai/sdk/android-sdk-link-interception)

## API Reference

Auto-generated documentation for all public classes, interfaces, enums, and data classes.

[Browse API Reference](https://docs.kindly.ai/sdk/android-sdk-api-reference)