MaixPy (v4)

快速落地 AI 视觉、听觉应用

快速开始 🚀📖 API 参考 📚 硬件平台：MaixCAM 📷 开源代码 ⭐️ 应用商店 📦

MaixPy-v1 (Maix-I K210) 用户请查看 MaixPy-v1 文档。 MaixPy v4 不支持 Maix-I Maix-II 系列硬件，请更新到 MaixCAM 硬件平台。
喜欢 MaixPy 请给 MaixPy 项目点个 Star ⭐️ 以鼓励我们开发更多功能。

简易的 API 设计， 10 行代码进行 AI 图像识别：

from maix import camera, display, image, nn

classifier = nn.Classifier(model="/root/models/mobilenetv2.mud")
cam = camera.Camera(classifier.input_width(), classifier.input_height(), classifier.input_format())
dis = display.Display()

while 1:
    img = cam.read()
    res = classifier.classify(img)
    max_idx, max_prob = res[0]
    msg = f"{max_prob:5.2f}: {classifier.labels[max_idx]}"
    img.draw_string(10, 10, msg, image.COLOR_RED)
    dis.show(img)

硬件外设控制，不在话下：

串口收发：

from maix import uart

devices = uart.list_devices()

serial = uart.UART(devices[0], 115200)
serial.write_str("hello world")
print("received:", serial.read(timeout = 2000))

I2C 收发：

from maix import i2c

devices = i2c.list_devices()
dev1 = i2c.I2C(devices[0], freq=100000)
slaves = dev1.scan()
print("find slaves:", slaves)
dev1.writeto(0x12, b'hello')
print("received:", dev1.readfrom(0x12, 5))

便捷的 MaixVision 工作站

简化开发环境，让开发更简单快速：

在线 AI 训练平台 MaixHub

无需 AI 基础和昂贵的训练设备，一键训练模型，一键部署到 MaixCAM。

性能强劲 MaixCAM 硬件平台

MaixCAM

CPU: 1GHz RISC-V(Linux)/ARM A53 + 700MHz RISC-V(RTOS) + 25~300MHz 8051(Low Power)

大核 RISC-V 和 ARM A53 二选一运行，MaixPy 使用 RISC-V 核心。

NPU: 1Tops@INT8 NPU, 支持 BF16，支持 YOLOv5 YOLOv8 等。
内存: 256MB DDR3。
通信: USB2.0/WiFi6/BLE5.4。
外设: IIC/PWM/SPI/UART/WDT/GPIO/ADC
多媒体：4M 摄像头，2.3" 552x368 高清电容触摸屏，H.264/H.265/MJPEG 2K 硬件编解码。
购买: 有各种版本硬件提供, 详情查看商城（缺货时咨询店家）

更多硬件细节看: MaixCAM 硬件文档

注意，目前只支持 MaixCAM 开发板，其它同型号芯片的开发板均不支持，包括 Sipeed 的同型号芯片开发板，请注意不要买错造成不必要的时间和金钱浪费, 量大优惠,批量可咨询商家或者发送邮件到 support@sipeed.com

特性介绍

以下为部分功能简介，更多请看文档、应用商店或者社区分享MaixHub。

Python + MaixVision IDE

简单的API，带有硬件加速，包含许多库，如numpy，opencv，MaixVision IDE 编程

C++版本

MaixCDK C++版本的SDK，与MaixPy的API相同, 商业友好

作为串口模块

其它 MCU 通过串口命令控制

APP商店

将您的APP分享给社区，并一键安装APPs。

提供 MaixPy-v1 兼容 API

快速从MaixPy-v1(K210)迁移到MaixPy-v4

AI 分类

识别物体类别

AI 对象检测

识别物体类别和坐标

AI 人脸识别

识别不同人脸特征

AI 人体关键点检测

姿态识别、体感游戏

AI 自学习分类器

无需在PC上训练，在设备上瞬间学习任意物体

AI 自学习检测器

无需在PC上训练，在设备上瞬间学习任意物体

AI 物体轨迹跟踪

轨迹追踪，流量统计

AI 监控，串流

安防监控，可串流，甚至可以向直播平台比如 Bilibili.com 直播

查找颜色

查找颜色斑点

巡线

小车巡线，物流搬运

QR码和AprilTag

识别QR码和AprilTag

OCR

识别图片中的字符，旧物数字化

语音识别

实时连续语音识别

桌面监视器

监视PC信息，如CPU，内存，网络等。

天气站

监视天气信息，如温度，湿度等。

热红外摄像头

选配摄像头，温度图像获取/测量

HDMI 捕获视频

选配，通过 HDMI 捕获图像，作为服务器监控（KVM）、外挂 AI、推流设备等

大屏视频播放

多种规格屏幕选择(2.3" 2.4" 5" 7"等), 硬件解码支持

谁在用 MaixPy？

AI 算法工程师：轻松将你的 AI 模型部署到嵌入式设备。

MaixPy 提供了易于使用的 API 来访问 NPU，以及帮助你开发 AI 模型的文档。

STEM：想要教学生 AI 和嵌入式开发的老师。

MaixPy 提供了易于使用的 API，PC 工具，在线 AI 训练服务... 让你专注于教授 AI，而不是硬件和复杂的软件使用。

创客: 想要制作一些酷炫的项目，但不想学习复杂的硬件和软件。

MaixPy 提供了 Python API，所以你需要做的就是学习基础 Python 语法，而 MaixPy 的 API 非常易于使用，你甚至可以在几分钟内完成你的项目。

工程师: 想要做一些项目，但希望尽快有一个原型。

MaixPy 易于构建项目，并提供相应的 C++ SDK，所以你可以直接使用 MaixPy 来部署或在几分钟内将 Python 代码转换为 C++。

学生：想要学习 AI，嵌入式开发。

我们提供了许多文档和教程，以及大量开源代码，帮助你找到学习路线，并逐步成长。从简单的 Python 编程到视觉，AI，音频，Linux，RTOS等。

企业: 想要开发 AI 视觉产品，但没有时间或工程师来开发复杂的嵌入式系统。

使用 MaixPy 甚至图形编程来开发你的产品，不需要更多的员工和时间。例如，向你的生产线添加一个 AI QA 系统，或者根据你的需求向你的办公室添加一个 AI 安全监控器。

竞赛者: 想要赢得比赛的比赛人们。

MaixPy 集成了许多功能，易于使用，加快你作品产出速度，以在有限的时间内赢得比赛，国内常见比赛都有很多同学使用 MaixPy 赢得比赛。

性能对比

相比上两代 Maix 系列产品有限的 NPU 算子支持和内存限制，MaixCAM 在保持超高性价比的同时，性能和体验有了很大的提升，强烈建议升级到最新的 MaixCAM 以及 MaixPy v4。

特征	Maix-I K210	Maix-II v831	MaixCAM
CPU	400MHz RISC-V x2	800MHz ARM7	1GHz RISC-V(Linux) 700MHz RISC-V(RTOS) 25~300MHz 8051(Low Power)
内存	6MB SRAM	64MB DDR2	256MB DDR3
NPU	0.25Tops@INT8 official says 1T but...	0.25Tops@INT8	1Tops@INT8
Encoder	✖	1080p@30fps	2K@30fps
屏幕	2.4" 320x240	1.3" 240x240	2.28" 552x368 / 5" 1280x720 / 7" 1280x800 / 10“ 1280x800
触摸屏	✖	✖	2.3" 552x368
摄像头	30W	200W	500W
WiFi	2.4G	2.4G	WiFi6 2.4G/5G
USB	✖	USB2.0	USB2.0
以太网	✖	100M(选配)	100M(选配)
SD 卡接口	SPI	SDIO	SDIO
BLE	✖	✖	BLE5.4
操作系统	RTOS	Tina Linux	Linux + RTOS
编程语言	C / C++ / MicroPython	C / C++ / Python3	C / C++ / Python3
Software	MaixPy	MaixPy3	MaixCDK + MaixPy v4 + opencv + numpy + ...
PC 软件	MaixPy IDE	MaixPy3 IDE	MaixVision Workstation
文档	⭐️⭐️⭐️⭐️	⭐️⭐️⭐️	🌟🌟🌟🌟🌟
在线 AI 训练	⭐️⭐️⭐️	⭐️⭐️⭐️⭐️	🌟🌟🌟🌟🌟
官方应用	⭐️⭐️	⭐️⭐️⭐️	🌟🌟🌟🌟🌟
AI 分类(224x224)	MobileNetv1 50fps MobileNetv2 ✖ Resnet ✖	MobileNet ✖ Resnet18 20fps Resnet50 ✖	MobileNetv2 130fps Resnet18 62fps Resnet50 28fps
AI 检测	YOLOv2(224x224) 15fps	YOLOv2(224x224) 15fps	YOLOv5s(224x224) 100fps YOLOv5s(320x256) 70fps YOLOv5s(640x640) 15fps YOLOv8n(640x640) 23fps
易用性	⭐️⭐️⭐️⭐️	⭐️⭐️⭐️	🌟🌟🌟🌟🌟

Maix 生态

MaixPy v1, MaixPy3 and MaixPy v4 有什么区别？

MaixPy v1 使用 MicroPython 编程语言，仅支持 Sipeed Maix-I K210 系列硬件，有限的第三方包。
MaixPy3 专为 Sipeed Maix-II-Dock v831 设计，不是长期支持版本。
MaixPy v4 使用 Python 编程语言，因此我们可以直接使用许多包。MaixPy v4 支持 Sipeed 的新硬件平台，这是一个长期支持版本，未来的硬件平台将支持这个版本。MaixPy v4 有一个 MaixPy-v1 兼容的 API，所以你可以快速将你的 MaixPy v1 项目迁移到 MaixPy v4。

(MaixPy v4 不支持 Maix-I K210 系列，如果你正在使用 Maix-I K210 系列，建议升级硬件平台以使用此版本，以获得更多功能和更好的性能。)

开源协议

所有在本仓库中的文件都遵循 Apache License 2.0 Sipeed Ltd. 协议，除了第三方库或者有自己的协议。

社区

项目分享: maixhub.com/share
讨论: maixhub.com/discussion
QQ 群: 862340358
Telegram: t.me/maixpy