Vibeleaderboard
Index / app
Visit github.com
Category
AI Tools
Rank
No. 1321Tools index

Previous survey · No. 1326 ·

Pricing
Open Source
Type
APP
Builder
openbmb
GitHub
378 stars
Latest release
v2.3
Date

About

Reference iOS/Swift apps showing how to run MiniCPM-V multimodal models on-device — drop-in starting point for vision apps.

What it does

Three mobile demo applications run language, vision-language, and speech models locally through a shared llama.cpp-based engine. Users can download GGUF weights inside the apps, select a model, then chat with text, analyze images or video, use live camera understanding, or synthesize speech.

Why it's ranked here

Its strongest case is breadth backed by working platform guidance. One repository covers three mobile systems, several model generations, text-only inference, and speech synthesis. Detailed memory estimates, model download instructions, device constraints, and automated iOS interaction tests make it more useful than a narrow proof of concept.

What's good

The documentation connects each model choice to download size and recommended device memory. The apps expose model management instead of assuming manually placed weights. Image slicing lets users trade visual detail for latency and token use. The iOS implementation also adapts batch and image limits by memory tier, supports immediate Chinese and English switching, and tests navigation, inference, image chat, and repeated interactions.

Tradeoffs

Local inference demands substantial storage and memory. Model downloads range from roughly 0.5 GB to 5.4 GB, with recommended memory from 4 GB to 8 GB. Android requires a physical 64-bit ARM device, while HarmonyOS needs its own development environment and signing. The first iOS source build must compile a large native framework locally, and device deployment may require an Apple developer account.

How to use it well

Use it to evaluate offline mobile inference, study native integration, or bootstrap experiments involving image chat, video understanding, text generation, and speech synthesis. It best suits mobile engineers comfortable with platform toolchains and large model assets. Treat the demos as implementation references and feasibility harnesses. Choose another component when you need hosted inference, a desktop application, or a platform-neutral service API.

Technical notes+

README.md defines the shared llama.cpp-omni submodule, platform builds, GGUF catalogue, memory guidance, and prebuilt package route. scripts/add_uitest_target.rb creates and wires an iOS UI test target, while MiniCPM-V-demoUITests/MiniCPMVDemoUITests.swift exercises navigation, text inference, image inference, model pages, and repeated controls. MiniCPM-V-demo/MTMDWrapper/MTMDParams.swift carries context, batch, GPU, slicing, and image-token limits into the C bridge. MiniCPM-V-demo/MTMDWrapper/MTMDWrapper.swift manages asynchronous initialization, prefill, streaming state, cancellation, errors, and watchdog timeouts. MiniCPM-V-demo/Sources/Localization/L10n.swift implements runtime Chinese and English dictionaries with persisted selection and fallback behavior.

Observed

Platforms
iOS 16.4+, Android on 64-bit ARM, and HarmonyOS NEXT API 12+
Application languages
Swift for iOS, Kotlin for Android, and ArkTS for HarmonyOS
Runtime interface
Native mobile graphical applications with chat, model management, image and video input, live camera understanding, and speech synthesis
Build surfaces
Xcode project, Gradle Android project, and DevEco Studio HarmonyOS project
Install surfaces
Prebuilt TestFlight, APK, and HAP packages are documented alongside source builds
Model packaging
GGUF model files, with separate vision projector weights for multimodal models and two files for the speech model
Shared inference layer
All three applications use the same shallow-configured llama.cpp-omni git submodule
Test structure
The repository includes an iOS end-to-end UI test target covering navigation and device-only model inference scenarios

Read from README.md, scripts/add_uitest_target.rb, MiniCPM-V-demo/AppDelegate.swift, MiniCPM-V-demo/SceneDelegate.swift, MiniCPM-V-demo-HarmonyOS/hvigorfile.ts, MiniCPM-V-demoUITests/MiniCPMVDemoUITests.swift, MiniCPM-V-demo/MTMDWrapper/MTMDError.swift, MiniCPM-V-demo/MTMDWrapper/MTMDToken.swift, MiniCPM-V-demo/MTMDWrapper/MTMDParams.swift, MiniCPM-V-demo-HarmonyOS/entry/hvigorfile.ts, MiniCPM-V-demo/MTMDWrapper/MTMDWrapper.swift, MiniCPM-V-demo/MTMDWrapper/MTMDWrapperExample.swift, MiniCPM-V-demo/Sources/Localization/L10n.swift, MiniCPM-V-demo/Sources/Localization/L10n+en.swift, MiniCPM-V-demo/Sources/Localization/L10n+zh.swift.

What it can do

  • Process images using multimodal AI models

    Image filesAI-generated analysis or descriptions

  • Run MiniCPM-V models locally on device

    Model files and user requestsOn-device AI inference results

  • Demonstrate vision-language model integration

    Images and text promptsMultimodal AI responses

  • Provide iOS Swift implementation template

    Developer requirementsReady-to-use iOS app code structure

  • Execute multimodal AI tasks without internet

    Local images and queriesOffline AI processing results

Tags

minicpmmultimodaliosswifton-device

Tech Stack

SwiftKotlinC++Objective-C++Objective-CShellCMakeRubyCTypeScript

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.