Skip to main content
Alpha Release. The Chatbase Android SDK is currently in alpha (v0.0.1-alpha03). APIs may change in future releases.
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 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 for how to handle this.

​
Next Steps

Installation & Quickstart

Add the SDK to your project and send your first message

Streaming

Real-time streaming with callbacks and Kotlin Flow

Client-Side Tools

Register local tool handlers the AI agent can invoke

Conversations

Manage conversations, history, and pagination

Error Handling

Exception hierarchy and error handling patterns