MiniCPM-V Apps 是一套在 iOS、Android 与 HarmonyOS 上运行的端侧多模态应用平台，采用 Apache 2.0 许可，对应模型版本 4.6.0。它通过 llama.cpp 在设备本地运行 MiniCPM-V 系列模型，无需联网。
一、项目简介
MiniCPM-V Apps 由 OpenBMB 维护，提供 iOS、Android、HarmonyOS 三端 Demo，共享同一套 llama.cpp-omni 子模块。仓库地址 https://github.com/OpenBMB/MiniCPM-V-Apps 。
二、项目功能
1. 三端演示
提供 iOS Xcode 工程、Android Gradle 工程与 HarmonyOS DevEco 工程，端到端全本地推理。
2. 多模型支持
支持 MiniCPM-V 2.6、4.0、4.6，以及文本模型与语音合成 VoxCPM2。
3. 模型管理
应用内置模型管理器，可下载或侧载 GGUF 模型文件，并标注硬件要求。
三、项目亮点
MiniCPM-V Apps 把多模态模型真正跑在手机上，离线可用且成本可控。对做端侧 AI 应用与验证模型体验的开发者较实用。
MiniCPM-V Apps vs QwenVL
对比 MiniCPM-V Apps 和 QwenVL 等云端多模态 API，差异在离线与隐私。应用在本地运行，云端需上传数据且依赖网络，更强调离线可用。若要替代 QwenVL 云端方案，端上部署是稳妥选择。两款方案在和隐私保护上的区别最为明显。
| 对比项 | MiniCPM-V Apps | QwenVL |
|---|---|---|
| 运行 | 本地 | 云端 |
| 隐私 | 数据不出设备 | 上传处理 |
| 联网 | 无需 | 依赖 |
四、项目结构
项目按三端分目录，共享 llama.cpp-omni 子模块，含模型文件说明、硬件要求与下载指引，结构清晰。
五、技术栈
- 推理引擎 llama.cpp
- iOS Swift、Android Kotlin、HarmonyOS ArkTS
- 模型格式 GGUF
- 许可 Apache 2.0
项目由 OpenBMB 维护，最后更新 2026 年，版本持续迭代到 4.6.0，更新记录见 GitHub 提交历史。仓库地址 https://github.com/OpenBMB/MiniCPM-V-Apps 。
六、本地快速部署启动
方式一 安装现成包
按 DOWNLOAD.md 下载 TestFlight、APK 或 HAP 包，直接安装体验。
方式二 构建 iOS
用 Xcode 打开工程，先运行脚本构建 llama.xcframework，再在设备上运行。
方式三 构建 Android
用 Android Studio 打开工程运行 gradlew assembleDebug，首次启动会下载模型文件。
适用场景与建议
适用场景方面，它适合想体验端侧多模态或做私密离线应用的开发。注意需满足设备的硬件要求，下载模型按建议内存选择。构建 iOS 需要 Xcode，Android 需 NDK，按官方文档逐步执行。
国内加速与备份
国内访问较慢时可用 ghfast.top 等镜像加速前缀，更详细的部署说明可扫码获取本站备份（sha256 373f8ee543a9a8dfe72f30283d009cd88f94467ea5bd6aa766e4c7079a256306）。备份包版本 v4.6。
七、项目代码地址
项目代码地址 https://github.com/OpenBMB/MiniCPM-V-Apps 。
常见问题
问. MiniCPM-V Apps 是什么
它是把 MiniCPM-V 模型跑在手机端的端上演示应用，覆盖三端。
问. 怎么快速体验
下载现成安装包，或在对应平台构建源码并下载模型。
问. 支持哪些模型
支持 MiniCPM-V 2.6、4.0、4.6，以及文本与语音模型。
问. 是否开源免费
项目以 Apache 2.0 协议开源，可免费使用与改造。
