MNN README

The project's README from github.com/alibaba/MNN. As one markdown file: README.md.

MNN

License Documentation 簡體中文版本 繁體中文版本 日本語バージョン MNN Homepage zread

MNN Chat App TaoAvatar Sana

News 🔥

History News
  • [2026/03/05] Support Qwen3.5 Series.

Icon Icon Icon

  • [2026/02/13] MNN-Sana-Edit-V2 is now available at apps, offering cartoon-style photo editing based on Sana.

Icon

  • [2025/10/16] Support Qwen3-VL Series.
  • [2025/06/11] New App MNN TaoAvatar released, you can talk with 3DAvatar offline with LLM, ASR, TTS, A2BS and NNR models all run local on your device!! MNN TaoAvatar

Icon

  • [2025/05/12] android app support qwen2.5 omni 3b and 7b MNN Chat App.

Icon Icon Icon

  • [2025/04/30] android app support qwen3 and dark mode MNN Chat App.

Icon

  • [2025/02/18] iOS multimodal LLM App is released MNN LLM iOS.

Icon

Icon

  • [2025/01/23] We released our full multimodal LLM Android App:MNN-LLM-Android. including text-to-text, image-to-text, audio-to-text, and text-to-image generation.

Icon Icon Icon Icon

Intro

MNN is a highly efficient and lightweight deep learning framework. It supports inference and training of deep learning models and has industry-leading performance for inference and training on-device. At present, MNN has been integrated into more than 30 apps of Alibaba Inc, such as Taobao, Tmall, Youku, DingTalk, Xianyu, etc., covering more than 70 usage scenarios such as live broadcast, short video capture, search recommendation, product searching by image, interactive marketing, equity distribution, security risk control. In addition, MNN is also used on embedded devices, such as IoT.

MNN-LLM is a large language model runtime solution developed based on the MNN engine. The mission of this project is to deploy LLM models locally on everyone's platforms(Mobile Phone/PC/IOT). It supports popular large language models such as Qianwen, Baichuan, Zhipu, LLAMA, and others. MNN-LLM User guide

MNN-Diffusion is a stable diffusion model runtime solution developed based on the MNN engine. The mission of this project is to deploy stable diffusion models locally on everyone's platforms. MNN-Diffusion User guide

architecture

Inside Alibaba, MNN works as the basic module of the compute container in the Walle System, the first end-to-end, general-purpose, and large-scale production system for device-cloud collaborative machine learning, which has been published in the top system conference OSDI’22. The key design principles of MNN and the extensive benchmark testing results (vs. TensorFlow, TensorFlow Lite, PyTorch, PyTorch Mobile, TVM) can be found in the OSDI paper. The scripts and instructions for benchmark testing are put in the path “/benchmark”. If MNN or the design of Walle helps your research or production use, please cite our OSDI paper as follows:

@inproceedings {proc:osdi22:walle,
    author = {Chengfei Lv and Chaoyue Niu and Renjie Gu and Xiaotang Jiang and Zhaode Wang and Bin Liu and Ziqi Wu and Qiulin Yao and Congyu Huang and Panos Huang and Tao Huang and Hui Shu and Jinde Song and Bin Zou and Peng Lan and Guohuan Xu and Fei Wu and Shaojie Tang and Fan Wu and Guihai Chen},
    title = {Walle: An {End-to-End}, {General-Purpose}, and {Large-Scale} Production System for {Device-Cloud} Collaborative Machine Learning},
    booktitle = {16th USENIX Symposium on Operating Systems Design and Implementation (OSDI 22)},
    year = {2022},
    isbn = {978-1-939133-28-1},
    address = {Carlsbad, CA},
    pages = {249--265},
    url = {https://www.usenix.org/conference/osdi22/presentation/lv},
    publisher = {USENIX Association},
    month = jul,
}

Documentation and Workbench

MNN's docs are in place in Read the docs.

You can also read docs/README to build docs's html.

MNN Workbench could be downloaded from MNN's homepage, which provides pretrained models, visualized training tools, and one-click deployment of models to devices.

Key Features

Lightweight

Versatility

High performance

Ease of use

The Architecture / Precision MNN supported is shown below:

Architecture / Precision Normal FP16 BF16 Int8
CPU Native B C B B
x86/x64-SSE4.1 A C C A
x86/x64-AVX2 S C C A
x86/x64-AVX512 S C C S
ARMv7a S S (ARMv8.2) S S
ARMv8 S S (ARMv8.2) S(ARMv8.6) S
GPU OpenCL A S C S
Vulkan A A C A
Metal A S C S
CUDA A S C A
NPU CoreML A C C C
HIAI A C C C
NNAPI B B C B
QNN C B C C

Tools

Base on MNN (Tensor compute engine), we provided a series of tools for inference, train and general computation.

How to Discuss and Get Help From the MNN Community

The group discussions are predominantly Chinese. But we welcome and will help English speakers.

Dingtalk discussion groups:

Group #4 (Available): 160170007549

Group #3 (Full)

Group #2 (Full): 23350225

Group #1 (Full): 23329087

Historical Paper

The preliminary version of MNN, as mobile inference engine and with the focus on manual optimization, has also been published in MLSys 2020. Please cite the paper, if MNN previously helped your research:

@inproceedings{alibaba2020mnn,
  author = {Jiang, Xiaotang and Wang, Huan and Chen, Yiliu and Wu, Ziqi and Wang, Lichuan and Zou, Bin and Yang, Yafeng and Cui, Zongyang and Cai, Yu and Yu, Tianhang and Lv, Chengfei and Wu, Zhihua},
  title = {MNN: A Universal and Efficient Inference Engine},
  booktitle = {MLSys},
  year = {2020}
}

License

Apache 2.0

Acknowledgement

MNN participants: Taobao Technology Department, Search Engineering Team, DAMO Team, Youku and other Alibaba Group employees.

MNN refers to the following projects:

MNN (alibaba/MNN)

Searching Database…

16.2K ·GitHub
Что это такое?MNN — это легковесный высокопроизводительный движок для инференса (и обучения) моделей глубокого обучения, созданный Alibaba. Он используется для эффективного запуска таких моделей, как LLM, диффузионные модели и CNN, на мобильных, встраиваемых и периферийных устройствах.
Это фреймворк, на котором я могу создавать приложения, или просто формат файлов моделей?Это полноценный фреймворк и набор инструментов для инференса и обучения: в него входят конвертер, сам вычислительный движок, инструменты сжатия и библиотека для компьютерного зрения в духе OpenCV, а также готовые рантайм-слои для LLM и диффузионных моделей поверх него.
Как запустить модель с помощью MNN?Сначала вы конвертируете существующую модель (TensorFlow, Caffe, ONNX или TorchScript) в формат MNN с помощью MNN-Converter, а затем запускаете её движком MNN через его C++ или Python API на целевом устройстве.
Нужны ли мне Python или набор инструментов для GPU, чтобы им пользоваться?Нет, MNN рассчитан на работу на устройстве без внешних зависимостей; при наличии он опционально использует Metal, OpenCL, Vulkan или CUDA для ускорения на GPU, а также предлагает Python API для более простого использования.
Одинаково ли хорошо работают все бэкенды?Нет, качество поддержки сильно зависит от бэкенда и точности: некоторые комбинации (например, CPU Native FP16 или NNAPI) помечены как содержащие ошибки или неоптимизированные ('B') либо вовсе не поддерживаются ('C'), тогда как другие, например ARM/AVX512, полностью оптимизированы ('S').
Кто уже использует MNN в продакшене?MNN интегрирован в более чем 30 приложений Alibaba (Taobao, Tmall, Youku, DingTalk, Xianyu) в более чем 70 сценариях, а также используется в IoT и других встраиваемых устройствах.
На каких платформах и устройствах он работает?MNN поддерживает iOS 8.0+, Android 4.3+ и другие встраиваемые устройства с интерфейсом POSIX, работая на CPU (x86/ARM) и GPU-бэкендах.
Не указано в READMEЛицензия Apache 2.0 — никаких заявленных ограничений сверх стандартных разрешительных условий.
Что такое MNN-LLM и какие модели он поддерживает?MNN-LLM — это рантайм на основе MNN для локального развёртывания больших языковых моделей на телефонах, ПК или IoT-устройствах. Поддерживаются модели Qianwen (Qwen), Baichuan, Zhipu, LLaMA, DeepSeek-R1 и Qwen3.
Есть ли готовое приложение, которое я могу попробовать, не собирая всё из исходников?Да, MNN выпустил приложения-чаты для Android и iOS (MNN-LLM-Android, MNN LLM iOS) с генерацией текста, работой с изображениями, преобразованием аудио в текст и созданием изображений по тексту, а также приложение MNN TaoAvatar для офлайн-разговоров с 3D-аватаром.
Насколько MNN компактнее других фреймворков?Он очень компактен: статическая библиотека для iOS весит около 12 МБ, а основная динамическая библиотека для Android — всего около 800 КБ. Необязательная минимальная сборка (MNNBUILDMINI) уменьшает размер пакета ещё примерно на 25%.
Зачем создали MNN, если можно было использовать TensorFlow Lite или PyTorch Mobile?MNN создан для собственных производственных задач Alibaba в связке «устройство — облако» и был протестирован в сравнении с TensorFlow, TensorFlow Lite, PyTorch, PyTorch Mobile и TVM; заявляется лидирующая в отрасли производительность на устройствах, что описано в статье OSDI'22.
Creator
alibaba
Size
357.2 MB
Stars
16.2K
Age
7y
Commits · 90 Days