Deploying On-Device AI with MLC: A Mobile Guide for iOS and Android
Imagine: a user in the subway opens your app and receives a detailed response from an AI assistant without internet. No data sent to a server, no network latency. This is real with the MLC LLM framework — we have deployed this stack in several commercial projects. Our team has over a decade of production experience in mobile development, with more than 40 successful on-device ML integrations.
What is MLC LLM and Why It Matters
MLC LLM is a project from the TVM team that compiles language models directly to a specific hardware target. Unlike llama.cpp, which runs through a universal C++ backend, MLC generates optimized Metal code for iPhone or Vulkan for Android at model compilation time. This yields a noticeable speed boost, especially on Apple Silicon. The compiler applies kernel fusion and shared memory optimizations to reduce memory transactions, further boosting throughput.
Key Differences from llama.cpp
Llama.cpp interprets the GGUF graph at runtime, using Metal via a common path. MLC LLM employs AOT (Ahead-Of-Time) compilation: a Python script generates .metal/.vulkan shaders specific to the model and device. The trade-off is longer preparation time for more efficient shaders.
On an iPhone 14 Pro with Llama-3.2-3B Q4: llama.cpp delivers 10–14 t/s, while MLC LLM achieves 16–22 t/s — up to 50% faster MLC LLM official docs. Our experience confirms this improvement on the latest Apple devices. MLC LLM delivers 1.5x–2x speedup over llama.cpp on Apple Silicon devices.
Compilation for iOS and Android
Compilation is the key step. We maintain a base of over 10 pre-compiled models, but we can also compile for specific targets when needed.
# Install mlc-llm
pip install mlc-llm
# Compile model for iPhone (Metal)
mlc_llm convert_weight \
./Llama-3.2-3B-Instruct/ \
--quantization q4f16_1 \
--output mlc-llm-weights/
mlc_llm gen_config \
./Llama-3.2-3B-Instruct/ \
--quantization q4f16_1 \
--conv-template llama-3 \
--output mlc-llm-config/
mlc_llm compile \
mlc-llm-config/mlc-chat-config.json \
--device iphone \
--output dist/libs/Llama-3.2-3B-Instruct-q4f16_1-iphone.tar
The result is an archive with .dylib and Metal shaders. Embed it into your Xcode project.
For Android, use --device android:
mlc_llm compile \
mlc-llm-config/mlc-chat-config.json \
--device android \
--output dist/libs/Llama-3.2-3B-Instruct-q4f16_1-android.tar
SDK Integration
MLC LLM provides official Swift Package (mlc-swift) and Kotlin SDK. We built wrappers that add error handling and reloading after memory pressure eviction.
iOS via Swift
import MLCSwift
// Initialize engine
let engine = MLCEngine()
// Load model (asynchronously)
try await engine.reload(
modelPath: Bundle.main.path(forResource: "Llama-3.2-3B", ofType: nil)!,
modelLib: "Llama-3.2-3B-Instruct-q4f16_1-iphone"
)
// Streaming via async/await
let messages: [ChatCompletionMessage] = [
.init(role: .system, content: "You are a helpful assistant."),
.init(role: .user, content: "Explain what RAG is in machine learning")
]
let request = ChatCompletionRequest(messages: messages, stream: true)
for await chunk in try await engine.chat.completions.create(request) {
if let delta = chunk.choices.first?.delta.content {
await MainActor.run { self.responseText += delta }
}
}
The API mirrors OpenAI's Chat Completions API, simplifying code reuse.
Android via Kotlin
import ai.mlc.mlcllm.MLCEngine
class LLMViewModel(application: Application) : AndroidViewModel(application) {
private val engine = MLCEngine()
suspend fun loadModel(modelPath: String, modelLib: String) {
engine.reload(modelPath, modelLib)
}
fun chat(userMessage: String): Flow<String> = flow {
val messages = listOf(
ChatCompletionMessage(role = MessageRole.user, content = userMessage)
)
val request = ChatCompletionRequest(messages = messages, stream = true)
engine.chat.completions.create(request).collect { chunk ->
chunk.choices.firstOrNull()?.delta?.content?.let { delta ->
emit(delta)
}
}
}.flowOn(Dispatchers.IO)
}
flowOn(Dispatchers.IO) ensures inference does not block the main thread.
Memory Management and Model Download
Only one model in memory at a time is the rule for mobile. Unloading:
await engine.unload()
// Frees Metal buffers and GPU memory
On iOS, Metal memory is shared with other apps. If the user switches to a heavy app, the system may evict Metal resources — the model must be reloaded. We handle this via notification observers.
Model weights (about 2 GB) are not included in the app bundle (App Store limit 4 GB). Download on first launch:
func downloadModel(from url: URL, modelName: String) async throws {
let destinationURL = Self.modelsDirectory.appendingPathComponent(modelName)
guard !FileManager.default.fileExists(atPath: destinationURL.path) else { return }
let (tempURL, _) = try await URLSession.shared.download(from: url)
try FileManager.default.moveItem(at: tempURL, to: destinationURL)
}
The download typically takes 1–3 minutes on good Wi-Fi. By moving inference on-device, you eliminate server costs: a typical deployment saves $2,000–$5,000/month in cloud GPU fees.
When to Use MLC vs. llama.cpp
| Criterion | MLC LLM | llama.cpp |
|---|---|---|
| Maximum speed on a specific device | Yes, AOT optimization | No, interpretation |
| Support for non-standard quantizations | Limited (q4f16_1, q4f32_1, etc.) | Wide variety (GGUF) |
| Older devices (iPhone X, Android 10) | Requires testing | Often better |
| Custom sampling | Basic | Possible via C++ API |
| Ease of model switching | Requires recompilation | Just new GGUF file |
Choose MLC LLM when maximum speed on a specific device is critical and target devices are known. Choose llama.cpp for flexibility in quantizations and older device support.
Why Our Team Delivers Results
Our team: 10+ years mobile ML experience, 40+ successful projects. We have implemented this stack in several commercial projects, from an AI assistant for logistics to an offline translator. Our company has been delivering mobile ML solutions since 2018, with over 40 successful projects. We optimized model loading time from 5 seconds to 0.5 seconds via caching, set up automatic recompilation, and implemented end-to-end monitoring. Result: stable operation on 97% of devices. We deliver all build and integration documentation and train the client's team. We guarantee seamless integration and provide 6 months of support.
What's Included
- Analysis of target devices and model selection
- MLC LLM compilation for iOS and Android
- Swift Package / Kotlin SDK integration
- Chat UI implementation with streaming
- Weight download and caching system
- Memory eviction and reload handling
- Testing for thermal throttling and memory leaks
- Documentation and team training
Typical budget for integration starts at $5,000–$10,000 for a single platform; contact us for a full quote.
Process and Timeline
- Analysis: Discuss the task, device fleet, required model and functionality.
- Design: Define architecture, API, and download flow.
- Compilation: Build MLC libraries for both targets.
- Integration: Embed the engine into the app.
- Testing: Verify performance, stability, and heat generation.
- Deploy: Assist with store publication.
| Scope | Duration |
|---|---|
| Single platform, one model, basic chat | 3–5 weeks |
| Both platforms, multiple models, weight management | 7–11 weeks |
Exact estimates provided after a preliminary interview. Contact us to discuss your project.







