Wiro AI Open Source

Wiro AI open source / LLM gateway and SDKs

Kotlin-QuickStart

Official Kotlin SDK for the Wiro AI API (WiroKit): run image, video, audio and LLM models from Android apps with coroutines and live task tracking.

View on GitHub Docs

Wiro AI

WiroKit for Android: Kotlin SDK for the Wiro AI API

Run image, video, audio and LLM models from Android apps in Kotlin with the Wiro AI API: typed requests, live task tracking and file uploads.

Kotlin 2.4+ Android API 26+ CI License: MIT

Website · Models · Docs · Dashboard

WiroKit for Android is the official Kotlin library for calling the
Wiro AI model API from Android apps (API 26+). It runs any
model in the Wiro AI catalog, through typed request factories for popular
image, video and music models or through Wiro.model with a parameter map,
and follows each task by polling or over a WebSocket with coroutines and
Flows. The repo also contains a Jetpack Compose example app that generates
images with FLUX.2 Pro.

Features

Requirements

Installation

The first public artifact has not been published to Maven Central yet. To
validate a local build:

./gradlew :wirokit:publishToMavenLocal

Add mavenLocal() before mavenCentral() in the consuming project, then use
the release candidate coordinates:

repositories {
    mavenLocal()
    mavenCentral()
}

After the first Maven Central release, remove mavenLocal() and use one of the
following dependency declarations.

Gradle (version catalog)

// libs.versions.toml
[libraries]
wirokit = { module = "ai.wiro:wirokit", version = "0.1.0" }

// module build.gradle.kts
dependencies {
    implementation(libs.wirokit)
}

Gradle (Kotlin DSL)

repositories {
    mavenCentral()
}

dependencies {
    implementation("ai.wiro:wirokit:0.1.0")
}

Quick start

import ai.wiro.wirokit.Wiro
import ai.wiro.wirokit.WiroClient
import ai.wiro.wirokit.WiroTaskResult
import ai.wiro.wirokit.subscribe

public suspend fun generateImage() {
    val client = WiroClient(apiKey = "your-api-key")
    try {
        val result = client.subscribe(
            Wiro.flux2Pro(
                prompt = "A cinematic mountain lake",
                width = 1024,
                height = 1024,
            ),
        )

        when (result) {
            is WiroTaskResult.Success ->
                println(result.task.outputs.firstOrNull()?.url)
            is WiroTaskResult.Failure ->
                println("Failed: ${result.reason}")
        }
    } finally {
        client.close()
    }
}

Mobile tip: Prefer WiroClient(proxyUrl = ..., headers = ...) in shipped
apps so long-lived API secrets never ship inside the binary.

Authentication

API key

val client = WiroClient(apiKey = "your-api-key")

API key + HMAC signature

val client = WiroClient(
    apiKey = "your-api-key",
    apiSecret = "your-api-secret",
)
val client = WiroClient(
    proxyUrl = "https://api.myapp.com/wiro/v1",
    headers = mapOf("Authorization" to "Bearer app-token"),
)

Your backend attaches Wiro AI credentials server-side. The SDK never stores an
API key in proxy mode.

Which call do I need?

I want to... Call
Generate with a supported model client.subscribe(Wiro.flux2Pro(...))
Run any other model client.subscribe(Wiro.model("owner/project", ...))
Fire-and-forget then wait run / runModel then waitForTask
Stream live status updates subscribeStream(...)
Find a model searchModels / explore
Inspect parameters getModelSchema then schema.validate
Send bytes WiroFileInput.Bytes(...)
Send a content URI WiroFileInput.ContentUri(...) + content source
Stop work Cancel the coroutine, or cancelTask / killTask

Typed and dynamic requests

Typed factories are available for these models. Any other model runs through
Wiro.model.

Category Models
Image FLUX.2 Pro, GPT Image 2, Nano Banana Pro, Seedream v4, Grok Imagine Image
Video Runway Gen-4.5, Seedance 2.0, Kling V3, Veo 3.1, Sora 2 Pro, Hailuo 2.3 Fast, Grok Imagine Video
Music Lyria 3
// Typed
val request = Wiro.flux2Pro(
    prompt = "Sunset over the bay",
    width = 1024,
    height = 1024,
)

// Dynamic model request
val dynamic = Wiro.model(
    slug = "black-forest-labs/flux-2-pro",
    parameters = mapOf(
        "prompt" to WiroValue.StringValue("Sunset over the bay"),
        "width" to WiroValue.number(1024),
        "height" to WiroValue.number(1024),
    ),
)

Polling and WebSocket tracking

import ai.wiro.wirokit.WiroTaskTrackingMode
import ai.wiro.wirokit.subscribeStream
import kotlinx.coroutines.flow.collect

// Default: polling `/Task/Detail`
client.subscribeStream(request).collect { update ->
    println(update.status?.apiValue)
}

// WebSocket with detail + polling fallback on early close
client.subscribeStream(
    request = request,
    trackingMode = WiroTaskTrackingMode.WEB_SOCKET,
).collect { update ->
    println(update.status?.apiValue)
}

subscribeStream is suspend and completes the billable /Run before
returning the Flow, so collecting (or re-collecting) never repeats the run.

Uploads

import ai.wiro.wirokit.WiroFileInput
import ai.wiro.wirokit.WiroUriContentSource

// In-memory bytes
val bytes = WiroFileInput.Bytes(
    bytes = imageBytes,
    fileName = "photo.png",
)

// Content URI (streamed; not fully buffered by default)
val uriInput = WiroFileInput.ContentUri(
    uri = contentUri,
    fileName = "photo.png",
)
val source = WiroUriContentSource.from(contentResolver)
client.uploadFile(uriInput, source)
// or ContentResolver overload: client.uploadFile(uriInput, contentResolver)

Unresolved file inputs inside run parameters are uploaded automatically before
/Run.

Coroutine cancellation and lifecycle

Security guidance

Example app

Open the app run configuration in Android Studio, or:

./gradlew :app:assembleDebug

Configure an API key or proxy URL in Settings for a debug build. Minified
release builds only accept a backend proxy URL. The demo generates a Flux 2
Pro image with live status, Coil rendering, and local/API cancel/kill.

Agent skill

This repository includes an agent skill, wiro-kotlin, in skills/wiro-kotlin/SKILL.md. It shows coding agents such as Claude Code, Codex and Cursor how to use WiroKit in Android and Kotlin apps. Add it to your agent with:

npx skills add wiroai/Kotlin-QuickStart --skill wiro-kotlin

Documentation

Development

./gradlew :wirokit:testDebugUnitTest :wirokit:verifyCoverageGate
./gradlew :app:testDebugUnitTest
./gradlew :wirokit:assembleRelease
./gradlew spotlessCheck detekt
./gradlew :wirokit:lintRelease :app:lintRelease
./gradlew :wirokit:releaseApiCheck
./gradlew :wirokit:publishToMavenLocal
./gradlew :consumer-fixture:testDebugUnitTest

More from Wiro AI

Repository What it is
Wiro-MCP Official MCP server for Wiro AI, @wiro-ai/wiro-mcp on npm
Wiro-LLM Vercel AI SDK provider for chat, images, speech, transcription and video, @wiro-ai/wiro-llm on npm
Wiro-Chromium-Extension Wiro AI extension for Chrome, Edge, Opera and Brave
Wiro-Firefox-Extension Wiro AI add-on for Firefox
Wiro-Safari-Extension Wiro AI extension for Safari on the Mac
Wiro-Plugin Wiro AI plugin for Cursor, Claude Code, Gemini CLI, Devin, Antigravity and Kiro
Wiro-Skills Agent skills for images, image edits, video, music, speech, transcripts, 3D and model search
Swift-QuickStart WiroKit, the Wiro AI SDK for iOS
Dart-QuickStart Wiro AI SDK for Dart and Flutter, wiro on pub.dev
ReactNative-QuickStart Wiro AI SDK for React Native and Expo, @wiro-ai/wiro-react-native on npm
Swift-Realtime Realtime voice AI example for iOS
Kotlin-Realtime Realtime voice AI example for Android
Dart-Realtime Realtime voice AI example for Flutter
ReactNative-Realtime Realtime voice AI example for React Native
n8n-nodes-wiro One Wiro AI node for n8n with a searchable model picker, @wiro-ai/n8n-nodes-wiro on npm
Wiro-Dify-Plugin Wiro AI plugins for Dify: the LLM gateway as a model provider, plus image, video, speech and music tools
Wiro-ComfyUI Wiro AI nodes for ComfyUI
Wiro-Hermes Wiro AI plugins for Hermes Agent: image, video, audio and 3D tools, plus the LLM gateway as a model provider
Wiro-Zed Wiro AI MCP server extension for Zed
Wiro-Action GitHub Action for Wiro AI models and the LLM gateway, on the GitHub Marketplace
Wiro-Raycast Wiro AI extension for Raycast: image and video generation, LLM chat and model search
Wiro-WordPress Wiro AI plugin for WordPress: featured images, image edits, alt text, narration and SEO suggestions
Wiro-Obsidian Wiro AI plugin for Obsidian: images, video, speech, music, transcription and text tools
Wiro-Blender Wiro AI add-on for Blender: text to 3D, image to 3D and textures
Wiro-Figma Wiro AI plugin for Figma: images, vectors, image edits and text
Wiro-Next-Starter Next.js starter for Wiro AI: Playground, image, video and audio tools, and LLM chat, ready for Vercel and Railway
Wiro-Docs Source of the Wiro AI API docs
wiroai.github.io Every open-source project from Wiro AI on one page, with a page for each repository

Website · Models · Docs · X

License

MIT. See LICENSE.

Wiro AI koala mascot