项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1635
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 Git,可克隆 GitHub 仓库
- 已安装 Docker,且宿主机为 x86 架构(用于交叉编译到 ARM)
- 网络可访问 GitHub 以下载 NDK 等依赖
- 建议预留至少 4G 共享内存(docker run 中设置了 --shm-size=4G)
安装与启动步骤
-
1克隆仓库
从 GitHub 拉取 mllm 源码,后续 Dockerfile 都在仓库的 docker 目录中。
git clone https://github.com/UbiquitousLearning/mllm.git -
2进入 docker 目录
Dockerfile.arm / Dockerfile.qnn 均位于仓库的 ./docker/ 目录下。
cd mllm/docker -
3构建 ARM 镜像
用 Dockerfile.arm 构建名为 mllm_arm 的镜像,构建过程会下载 NDK,需耐心等待。
docker build -t mllm_arm -f Dockerfile.arm . -
4启动开发容器
以特权相关参数启动容器并进入 bash,便于在容器内交叉编译与调试 mllm。
docker run -it --cap-add=SYS_ADMIN --network=host --cap-add=SYS_PTRACE --shm-size=4G --security-opt seccomp=unconfined --security-opt apparmor=unconfined --name mllm_arm_dev mllm_arm bash
如何确认成功
执行 docker run 后能直接进入容器内的 bash 提示符,即表示镜像构建与启动成功;镜像列表可用 docker images 查看 mllm_arm。
常见问题
Q:必须用 Docker 才能用 mllm 吗?
A:README 只给出了 Docker 这条推荐路径(提供 arm 与 qnn 两种交叉编译镜像),非 Docker 的本地编译方式请查阅官网文档。
Q:为什么 QNN SDK 不在镜像里?
A:QNN SDK 含专有许可条款,官方未将其打包进 Dockerfile.qnn,需要你自行手动配置 QNN SDK 路径。
Q:构建镜像会额外下载什么?
A:Dockerfile.arm 会下载 NDK,使用该镜像即表示你同意 NDK 的附加条款。
Q:怎么把 mllm 集成进自己的 C++ 项目?
A:在 CMake 中用 target_link_libraries 链接 mllm::MllmRT 与 mllm::MllmCPUBackend 目标即可。
注意事项
- Dockerfile.arm 会下载 NDK,使用该镜像即视为同意 NDK 的附加条款。
- QNN SDK 含专有许可未打包,需自行配置;细节见 docker/README.md。
- 在自己项目中链接运行时可写:target_link_libraries(fancy_algorithm PRIVATE mllm::MllmRT mllm::MllmCPUBackend)。
- README 未给出具体的模型下载与推理运行命令,请参考官网文档与 examples 目录。
核心亮点
- 专门为移动端优化,推理速度和内存占用优于通用框架
- 支持多种量化技术,降低模型部署门槛
- C++ 实现,跨平台性好,易于集成到 Android/iOS 应用
不足之处
- 项目仍处于早期,API 和功能稳定性有待提升
- 支持的模型架构有限,生态不如 llama.cpp 丰富
适用场景
- 在手机上实现离线图像问答和视觉辅助
- 开发低延迟的移动端 AI 助手,无需联网
- 在嵌入式设备上部署多模态模型进行实时推理
替代项目
llama.cpp、MLC LLM、MediaPipe LLM Inference
上一篇:ModernBERT
下一篇:VibeThinker
同类项目推荐
awesome-vla-for-ad
开源
一榜看尽VLA自动驾驶研究脉络,快速入门与追踪前沿
Vision-Language-Action Models for Autonomous Driving: Past, Present, and Future
InternVL
开源
开源接近GPT-4o的多模态对话模型,图像理解与对话一步到位。
[CVPR 2024 Oral] InternVL Family: A Pioneering Open-Source Alternative to GPT-4o. 接···
recursive-llm
开源
把百万字上下文丢进 REPL,让模型写代码按需读,省 token 做长文分析
Recursive Language Models for efficient long-context processing. Analyze 1M+ tokens ···
llama2-webui
开源
本地一键运行 Llama 2,网页聊天即刻上手
Run any Llama 2 locally with gradio UI on GPU or CPU from anywhere (Linux/Windows/Ma···
ViP-LLaVA
开源
用点、框、涂鸦任意指,模型就能看懂你指的地方
[CVPR2024] ViP-LLaVA: Making Large Multimodal Models Understand Arbitrary Visual Pro···
awesome-vlm-architectures
开源
一张图看懂155+视觉语言模型架构,快速选型不迷路
Curated visual catalog of 200+ vision-language model (VLM/MLLM) architectures: paper···
Awesome-LLM-KG
开源
一页看懂LLM与知识图谱融合的所有关键论文
Awesome papers about unifying LLMs and KGs
Awesome-Reasoning-Foundation-Mod···
开源
一站式追踪推理模型最新论文与基准
✨✨Latest Papers and Benchmarks in Reasoning with Foundation Models
gemma
开源
谷歌开放权重模型,本地单卡即可跑推理和微调
Gemma open-weight LLM library, from Google DeepMind
