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)
}
}
}