> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Android SDK Overview

> Introduction to the Chatbase Android SDK — a Kotlin-first library for building conversational AI experiences on Android.

> [!NOTE]
>
> **Alpha Release.** The Chatbase Android SDK is currently in alpha (v0.0.1-alpha03). APIs may change in future releases.

> [!TIP]
>
> **Want the full chat without building a UI?** Load the chat in a WebView. It's the simplest way to add your agent to an app, with the same chat, actions, forms, tickets and voice as your website. See [Mobile apps](https://chatbase.co/docs/developer-guides/website-integration/iframe.md#mobile-apps). Use the SDK when you want your own native chat UI.

> [!WARNING]
>
> Conversation methods apply exclusively to conversations created through the mobile SDKs (Android and iOS). Conversations generated through the widget, the API, or external integrations cannot be accessed using the SDK. A user identified on both platforms sees their Android and iOS SDK conversations together.

## What is the Chatbase Android SDK?

The Chatbase Android SDK is a Kotlin-first library that lets you integrate Chatbase AI agents into your Android app. It provides:

* **Real-time streaming** with two levels of abstraction
* **Client-side tools** that let the AI agent invoke local functions on the device
* **User identity** with JWT-based authentication and automatic device ID tracking
* **Conversation management** with cursor-based pagination
* **Structured error handling** with typed exceptions

## Requirements

Android API 24 (Android 7.0), Java 11, and Kotlin Coroutines. See [Installation & Quickstart](https://chatbase.co/docs/android-sdk/quickstart.md) for the full prerequisites and setup.

## Rate Limits

The Chatbase API enforces a rate limit of **1,000 requests per 10 seconds** per device, applied server-side. When the limit is exceeded, the SDK throws an `ApiException` with `isRateLimited == true`. See [Error Handling](https://chatbase.co/docs/android-sdk/error-handling.md) for how to handle this.

## Next Steps

> **[Installation & Quickstart](https://chatbase.co/docs/android-sdk/quickstart.md)**
>
> Add the SDK to your project and send your first message

> **[Streaming](https://chatbase.co/docs/android-sdk/streaming.md)**
>
> Real-time streaming with callbacks and Kotlin Flow

> **[Client-Side Tools](https://chatbase.co/docs/android-sdk/client-side-tools.md)**
>
> Register local tool handlers the AI agent can invoke

> **[Conversations](https://chatbase.co/docs/android-sdk/conversations.md)**
>
> Manage conversations, history, and pagination

> **[Error Handling](https://chatbase.co/docs/android-sdk/error-handling.md)**
>
> Exception hierarchy and error handling patterns


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.