Eve library

Android Kotlin SDK Integration Guide

Guide

Revision 1

On this page

Complete guide for integrating the Lilith Android SDK into your Kotlin applications.

Installation#

Gradle Configuration#

Add to your app-level build.gradle:

kotlin
dependencies {
    implementation 'com.lilith:android-sdk:1.0.0'
}

Maven Configuration#

xml
<dependency>
    <groupId>com.lilith</groupId>
    <artifactId>android-sdk</artifactId>
    <version>1.0.0</version>
</dependency>

Configuration#

Basic Setup#

kotlin
import com.lilith.sdk.LilithClient
import com.lilith.sdk.LilithConfig

class MyApplication : Application() {
    lateinit var lilithClient: LilithClient

    override fun onCreate() {
        super.onCreate()

        val config = LilithConfig.Builder()
            .apiKey("your-api-key-here")
            .baseUrl("https://api.lilith.app")
            .timeout(30000)
            .build()

        lilithClient = LilithClient(config)
    }
}

Permissions#

Add to your AndroidManifest.xml:

xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WAKE_LOCK" />

Basic Usage#

Authentication#

kotlin
class AuthActivity : AppCompatActivity() {
    private lateinit var client: LilithClient

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        client = (application as MyApplication).lilithClient

        authenticateUser()
    }

    private suspend fun authenticateUser() {
        try {
            val auth = client.auth.login(
                email = "user@example.com",
                password = "secure-password"
            )

            // Store token securely
            storeTokenSecurely(auth.accessToken)

            // Navigate to main activity
            startActivity(Intent(this, MainActivity::class.java))
            finish()
        } catch (e: Exception) {
            Log.e("Auth", "Login failed", e)
            showError("Authentication failed: ${e.message}")
        }
    }
}

Chat Integration#

kotlin
class ChatActivity : AppCompatActivity() {
    private lateinit var client: LilithClient
    private lateinit var chatAdapter: ChatAdapter

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_chat)

        client = (application as MyApplication).lilithClient
        setupRecyclerView()
        setupInputField()
    }

    private suspend fun sendMessage(text: String) {
        try {
            val request = ChatRequest(
                persona = "zen_master",
                input = ChatInput.Text(text),
                mode = "text",
                options = ChatOptions(
                    cite = true,
                    stream = false
                )
            )

            val response = client.chat.create(request)

            runOnUiThread {
                chatAdapter.addMessage(Message("user", text))
                chatAdapter.addMessage(Message("assistant", response.text))
            }
        } catch (e: Exception) {
            Log.e("Chat", "Message failed", e)
            runOnUiThread {
                showError("Failed to send message: ${e.message}")
            }
        }
    }
}

Advanced Features#

Voice Chat Integration#

kotlin
class VoiceChatActivity : AppCompatActivity() {
    private lateinit var audioRecorder: AudioRecorder
    private lateinit var audioPlayer: AudioPlayer

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        setupAudioComponents()
        setupVoiceChat()
    }

    private suspend fun startVoiceChat() {
        try {
            // Record audio
            val audioData = audioRecorder.record(maxDurationMs = 30000)

            // Send to API
            val request = ChatRequest(
                persona = "zen_master",
                input = ChatInput.Audio(audioData.toBase64()),
                mode = "voice"
            )

            val response = client.chat.create(request)

            // Play response audio
            response.audioUrl?.let { url ->
                audioPlayer.play(url)
            }
        } catch (e: Exception) {
            Log.e("VoiceChat", "Voice interaction failed", e)
        }
    }
}