sumopod-ai-sdk

0.1.1indexed

OpenAI-compatible SDK offering chat completions (streaming and non-streaming), text embeddings, model browsing across 40+ models, SSE streaming, thread-safe singleton, and API-key redaction.

AndroidJVMNative·MozeeB/sumopod-ai-sdk

Stars

—

Used by

dependents

—

Health

/ 100

Sumopod AI SDK

Kotlin Multiplatform SDK for the Sumopod AI API
OpenAI-compatible with 40+ models across multiple providers

Kotlin Platform

Installation

Kotlin DSL	Groovy
`implementation("com.cikup.sumopod.ai:sumopod-ai-sdk:0.1.1")`	`implementation 'com.cikup.sumopod.ai:sumopod-ai-sdk:0.1.1'`

Kotlin Multiplatform:

commonMain.dependencies {
    implementation("com.cikup.sumopod.ai:sumopod-ai-sdk:0.1.1")
}

Features

Quick Start

1. Initialize

Sumopod.init("sk-your-api-key")

// Or with custom config
Sumopod.init("sk-your-api-key") {
    baseUrl = "https://ai.sumopod.com/v1"
    timeout { connect = 15_000; request = 120_000 }
    logLevel = SumopodConfig.LogLevel.HEADERS
}

2. Chat Completion

val response = Sumopod.chatCompletion(
    ChatCompletionRequest(
        model = "gpt-4o-mini",
        messages = listOf(
            ChatMessage(role = ChatRole.User, content = "Hello!")
        ),
        maxTokens = 150,
    )
)
println(response.choices.first().message.content)

3. Streaming

Sumopod.chatCompletionStream(request).collect { chunk ->
    print(chunk.choices.firstOrNull()?.delta?.content.orEmpty())
}

// Or collect all at once
val fullText = Sumopod.chatCompletionStream(request).collectContent()

4. Shorthand

val response = Sumopod.chat(
    "gpt-4o-mini",
    ChatRole.User to "What is Kotlin Multiplatform?",
    maxTokens = 200,
)

5. Embeddings

val response = Sumopod.embeddings(
    EmbeddingRequest(model = "text-embedding-3-small", input = "Hello world")
)

6. List Models

val models = Sumopod.models()
models.data.forEach { println(it.id) }

7. Cleanup

Sumopod.close()

Available Models

40+ models across providers. See the full list at Sumopod Models.

Platform Support

Platform	Engine

Sample App

Compose Multiplatform demo with Chat, Models, and Settings screens.

./gradlew :sample:run              # Desktop
./gradlew :sample:assembleDebug    # Android
open sample/iosApp/iosApp.xcodeproj  # iOS (Xcode)

Security

API keys never logged or serialized
HTTPS-only (http:// URLs rejected)
All inputs validated before API calls
Error messages never contain sensitive data
SumopodConfig.toString() redacts API key
Thread-safe singleton with @Volatile fields

Testing

173 automated tests across 5 test suites:

./gradlew :library:jvmTest               # 37 tests
./gradlew :library:testAndroidHostTest    # 62 tests
./gradlew :library:iosSimulatorArm64Test  # 37 tests
./gradlew :sample:testDebugUnitTest       # 22 tests
./gradlew :sample:desktopTest             # 15 Compose UI tests

Dependencies

Library	Version

License

Copyright 2026 Cikup

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Related libraries

Surfaced from shared tags and platforms — no rankings paid for.

KSafe★ 301

ioannisaEffortlessly encrypts and persists data using hardware-backed security, offering one-code-path simplicity, seamless integration, and protection for sensitive information like OAuth tokens.Shared: kotlin-serialization, kotlin-flow, kotlin-coroutines

konnection★ 170

TM-AppsLibrary emits network connection status, offers immediate connection state checks, IP info retrieval, and network state observation. Supports customizable instance creation and includes default IP resolvers.Shared: sdk, kotlin-flow, kotlin-coroutines

kotlin-sdk★ 1.4k

modelcontextprotocolImplements the Model Context Protocol, enabling client and server integration with LLM surfaces. Supports standard transports, handles protocol messages, and offers sample setups for server and client configurations.Shared: service-sdk, sdk, kotlin-multiplatform-sample

Scratchify★ 88

gsrathoreniksLightweight SDK enables creation of interactive scratch cards, revealing hidden content for rewards, discounts, and gamification. Features customizable brush size, auto-reveal, and scratch event callbacks.Shared: sdk, kotlin-multiplatform-sample, compose-multiplatform

Kotlin-BLE-Library★ 515

nordicsemiSimplifies Bluetooth Low Energy usage with coroutine-based asynchronous APIs: scanning, connecting (autoConnect), GATT reads/writes, MTU/PHY management, notifications, and mock environments for testing.Shared: sdk, kotlin-flow, kotlin-coroutines

amplify-android★ 287

aws-amplifyHigh-level toolkit for interacting with AWS services via category-based APIs and plugin drivers—auth, storage, analytics, geo, GraphQL—plus SDK escape hatches and Rx/async adapters.Shared: service-sdk, sdk, kotlin-coroutines

Chat Completions	Streaming and non-streaming responses
Embeddings	Text embedding generation
Model Listing	Browse 40+ available models
Multiplatform	Android, iOS, and JVM from a single codebase
Streaming	SSE streaming via Kotlin `Flow` with `collectContent()`
Thread-Safe	`Sumopod` singleton with `@Volatile` fields
Secure	API key redaction, HTTPS-only, input validation
Tested	173 automated tests across all platforms

OpenAI	gpt-4o, gpt-4o-mini, gpt-4.1, gpt-5, gpt-5.1, gpt-5.2
Anthropic	claude-haiku-4-5
Google	gemini-2.0-flash, gemini-2.5-flash, gemini-2.5-pro, gemini-3-flash
BytePlus	deepseek-r1, deepseek-v3-2, seed-2-0-pro, kimi-k2
Z.AI	glm-5, glm-5-code, glm-5-turbo, glm-5.1

Android	OkHttp	API 24
iOS	Darwin (NSURLSession)	iOS 13
JVM	CIO	Java 11

Kotlin	2.2.20
Ktor	3.3.1
kotlinx.serialization	1.9.0
kotlinx.coroutines	1.10.2
Compose Multiplatform	1.10.3