MaixPy (v4)

Let's Sipeed up, Maximize AI's power!

MaixPy (v4): Easily create AI projects with Python on edge device

Quick Start | Documentation | API | Hardware

GitHub Repo stars Apache 2.0 PyPI PyPI - Downloads GitHub repo size Build MaixCAM Trigger wiki

English | 中文

MaixCAM

Feature Overview

MaixPy offers simple Python programming combined with powerful edge computing hardware. Integrated hardware peripheral operations, video streaming, AI vision algorithms, and audio algorithms etc. With its plug-and-play design, MaixPy enables you to quickly implement your intelligent projects.

Additionally, MaixPy provides the MaixVision IDE, MaixHub online training platform, detailed documentation, and even a C/C++ SDK with identical APIs, ensuring seamless development and production deployment.

Here is a partial video demonstration of the features. For more documentation, please visit the official website: wiki.sipeed.com/maixpy/

If you like this project, please click Star on the top right of the MaixPy Project to encourage us to develop more exciting content!

Concise and Efficient Code (API) Design

With MaixPy you can easily create AI vision project within 10 lines of code:

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())
disp = 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)
    disp.show(img)

Result:

Edge(embeded) friendly

Simply use hardware peripheral like serial port:

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))

MaixVision workstation

We also provide a handy MaixVision workstation software to make development easier and faster:

MaixVision

MaixHub online platform

MaixHub provide free online AI train service, one click to train AI model and deploy to MaixCAM even you have no AI knowledge and expensive training equipment.

MaixHub

Hardware platform MaixCAM

And we provide two powerful hardware platform MaixCAM and MaixCAM-Pro, with datasheet register level open.

MaixCAM

CPU NPU Memory
- 1GHz RISC-V(Linux)
- 700MHz RISCV-V(RTOS)
- 25~300MHz 8051(LowPower)		 1Tops@INT8 NPU, support BF16
support YOLOv5 YOLOv8 etc.		 256MB DDR3
Connecting Peripheral MultiMedia Buy
USB2.0/WiFi6/BLE5.4 IIC/PWM/SPI/UART/WDT/ADC - 4M Camera
- 2.3" 552x368 Touchscreen
- H.264/H.265/MJPEG codec		 Sipeed Official Store

Who are using MaixPy?

  • AI Algorithm Engineer who want to deploy your AI model to embedded devices.

MaixPy provide easy-to-use API to access NPU, and docs to help you develop your AI model.

  • STEM teacher who wants to teach AI and embedded devices to students.

MaixPy provide easy-to-use API, PC tools, online AI train service ... Let you focus on teaching AI, not the hardware and complicated software usage.

  • Maker who want to make some cool projects but don't want to learn complicated hardware and software.

MaixPy provide Python API, so all you need is learn basic Python syntax, and MaixPy's API is so easy to use, you can make your project even in a few minutes.

  • Engineer who want to make some projects but want a prototype as soon as possible.

MaixPy is easy to build projects, and provide corresponding C++ SDK, so you can directly use MaixPy to deploy or transfer Python code to C++ in a few minutes.

  • Students who want to learn AI, embedded development.

We provide many docs and tutorials, and lot of open source code, to help you find learning route, and grow up step by step. From simple Python programming to Vision, AI, Audio, Linux, RTOS etc.

  • Enterprise who want to develop AI vision products but have no time or engineers to develop complicated embedded system.

Use MaixPy even graphic programming to develop your products with no more employees and time. For example, add a AI QA system to your production line, or add a AI security monitor to your office as your demand.

  • Contestants who want to win the competition.

MaixPy integrate many functions and easy to use, fasten your work to win the competition in limited time. There are already many contestants win the competition with MaixPy.

Performance comparison

K210 and v831 are outdated, they have many limitations in memory, performance, NPU operators missing etc.
No matter you are using them or new comer, it's recommended to upgrade to MaixCAM and MaixPy v4.

Here's the comparison between them:

Feature 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)
Memory 6MB SRAM 64MB DDR2 256MB DDR3
NPU 0.25Tops@INT8
official says 1T but...		 0.25Tops@INT8 1Tops@INT8
Encoder ✖ 1080p@30fps 2K@30fps
Screen 2.4" 320x240 1.3" 240x240 2.28" 552x368 / 5" 1280x720 / 7" 1280x800 / 10“ 1280x800
TouchScreen ✖ ✖ 2.3" 552x368
Camera 30W 200W 500W
WiFi 2.4G 2.4G WiFi6 2.4G/5G
USB ✖ USB2.0 USB2.0
Eth ✖ 100M(Optional) 100M(Optional)
SD Interface SPI SDIO SDIO
BLE ✖ ✖ BLE5.4
OS RTOS Tina Linux Linux + RTOS
Language C / C++ / MicroPython C / C++ / Python3 C / C++ / Python3
Software MaixPy MaixPy3 MaixCDK + MaixPy v4 + opencv + numpy + ...
PC software MaixPy IDE MaixPy3 IDE MaixVision Workstation
Docs ⭐️⭐️⭐️⭐️ ⭐️⭐️⭐️ 🌟🌟🌟🌟🌟
Online AI train ⭐️⭐️⭐️ ⭐️⭐️⭐️⭐️ 🌟🌟🌟🌟🌟
Official APPs ⭐️⭐️ ⭐️⭐️⭐️ 🌟🌟🌟🌟🌟
AI classify(224x224) MobileNetv1 50fps
MobileNetv2 ✖
Resnet ✖		 MobileNet ✖
Resnet18 20fps
Resnet50 ✖		 MobileNetv2 130fps
Resnet18 62fps
Resnet50 28fps
AI detect(NPU forward part) YOLOv2(224x224) 15fps YOLOv2(224x224) 15fps YOLOv5s(224x224) 100fps
YOLOv5s(320x256) 70fps
YOLOv5s(640x640) 15fps
YOLOv8n(640x640) 23fps
YOLO11n(224x224)175fps
YOLO11n(320x224)120fps
YOLO11n(320x320)95fps
YOLO11n(640x640)23fps
Ease of use ⭐️⭐️⭐️⭐️ ⭐️⭐️⭐️ 🌟🌟🌟🌟🌟

Maix Ecosystem

MaixPy not only a Python SDK, but have a whole ecosystem, including hardware, software, tools, docs, even cloud platform etc. See the picture below:

What difference between MaixPy v1, MaixPy3 and MaixPy v4?

  • MaixPy v1 use MicroPython programming language, only support Sipeed Maix-I K210 series hardware, have limited third-party packages.
  • MaixPy3 is designed for Sipeed Maix-II-Dock v831, not a long-term support version.
  • MaixPy v4 use Python programming language, so there's much package we can use directly. MaixPy v4 support new hardware platforms of Sipeed, it's a long-term support version, the future's hardware platforms will support this version. MaixPy v4 have a MaixPy-v1 compatible API, so you can quickly migrate your MaixPy v1 project to MaixPy v4.

(MaixPy v4 Will not support Maix-I K210 series, if you are using Maix-I K210 series, it's recommended to upgrade hardware platform to use this to get more features and better performance.)

Compile Source Code

If you want to compile MaixPy firmware from source code, refer to Build MaixPy source code page.

License

All files in this repository are under the terms of the Apache License 2.0 Sipeed Ltd. except the third-party libraries or have their own license.

Community

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (4.12.5)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Neucrack from gravatar.com Neucrack

Credits

Author: Sipeed

License

Apache Software License (Apache 2.0)

Tags

Machine vision AI vision IOT AIOT Edge computing

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

maixpy-4.11.8-cp313-cp313-manylinux2014_x86_64.whl (4.1 MB view details)

Uploaded CPython 3.13

maixpy-4.11.8-cp312-cp312-manylinux2014_x86_64.whl (4.1 MB view details)

Uploaded CPython 3.12

maixpy-4.11.8-cp311-cp311-manylinux2014_x86_64.whl (4.1 MB view details)

Uploaded CPython 3.11

maixpy-4.11.8-cp310-cp310-manylinux2014_x86_64.whl (4.1 MB view details)

Uploaded CPython 3.10

maixpy-4.11.8-cp39-cp39-manylinux2014_x86_64.whl (4.1 MB view details)

Uploaded CPython 3.9

maixpy-4.11.8-cp38-cp38-manylinux2014_x86_64.whl (4.1 MB view details)

Uploaded CPython 3.8

MaixPy-4.11.8-py3-none-any.whl (16.3 MB view details)

Uploaded Python 3

File details

Details for the file maixpy-4.11.8-cp313-cp313-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for maixpy-4.11.8-cp313-cp313-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 6db7d4a6f28e0d61981d7ebb85c87132e5b55bf1fa452d3257cfaf5c22baba1a
MD5 9f7a49effb7f7fd93dd1ca6c2895af7c
BLAKE2b-256 bc76a8a9fad4af35a6a997371c44cd1a8aa10d81644ff793614a2e3bb683dbf2

See more details on using hashes here.

File details

Details for the file maixpy-4.11.8-cp312-cp312-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for maixpy-4.11.8-cp312-cp312-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 2a821fb550f7b1a8e53afd63cb3d5cc8265892007a22d00ccbc8594fd0a451c7
MD5 881c33a77d9c7b522f25f6c6e5beeecd
BLAKE2b-256 1f3ddffcee2561ff2f28b20e77eb9f74267ad1f5131cc8143f5940841ec504dc

See more details on using hashes here.

File details

Details for the file maixpy-4.11.8-cp311-cp311-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for maixpy-4.11.8-cp311-cp311-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 3e503c51471ee135b7f9bde61e7874dde4fdf245217932e364b82c69791cd754
MD5 9e80a2a83a3ec48365bbe48bd42c6c51
BLAKE2b-256 943b4f8aab106ddaa80c63d18fdedcb2fae7dfb8d56064a14c7cccfc02e2850a

See more details on using hashes here.

File details

Details for the file maixpy-4.11.8-cp310-cp310-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for maixpy-4.11.8-cp310-cp310-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 d9db144c064747249b802247bfd5ae642ce78dcec9b569dcee5d59b69231dac9
MD5 d1cb0346d8e86fa53883ff510a005034
BLAKE2b-256 b7be54d83412a279ea8c15f97c7058b0b99cc2c0165c3f8eadc467f623af35e4

See more details on using hashes here.

File details

Details for the file maixpy-4.11.8-cp39-cp39-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for maixpy-4.11.8-cp39-cp39-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 27f859294c3133ba6bc11ef8c272605c21c1e709b9762561cd92205664b2166a
MD5 6c20922b951e04d8634ea1209f4b2732
BLAKE2b-256 d42f3c3d575867732a0dccddaee6747797f6208157f2bcdb059018045d33ab3d

See more details on using hashes here.

File details

Details for the file maixpy-4.11.8-cp38-cp38-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for maixpy-4.11.8-cp38-cp38-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 8e9af05efec49966a8013568fab2edb0a17167b18de511a2045f16e1b27be12d
MD5 d065a2d9a8459aa1a03f05eb409b2c8f
BLAKE2b-256 c00d855d905107a986231d926c733a51d97b8d0011ca55a71f60250a75b879f5

See more details on using hashes here.

File details

Details for the file MaixPy-4.11.8-py3-none-any.whl.

File metadata

  • Download URL: MaixPy-4.11.8-py3-none-any.whl
  • Upload date:
  • Size: 16.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.13

File hashes

Hashes for MaixPy-4.11.8-py3-none-any.whl
Algorithm Hash digest
SHA256 0c7a3a1dc9e5aa236f96761b2f19216c5b6713c75275f28d8e1616b8b1034e98
MD5 cdb7a460857b5088926b9f841c59f463
BLAKE2b-256 aa668124a9ae95f92feec5d70ce7d76415f816e2017ae4440b40bb7b515e8556

See more details on using hashes here.

Release history Release notifications | RSS feed

4.12.5

5 files

4.12.4

5 files

4.12.1

7 files

4.12.0

7 files

4.11.9

7 files

This release

4.11.8 This release

7 files

4.11.7

7 files

4.11.6

7 files

4.11.5

6 files

4.11.4

5 files

4.11.3

6 files

4.11.2

5 files

4.11.1

5 files

4.11.0

5 files

4.10.3

6 files

4.10.2

6 files

4.10.1

6 files

4.10.0

6 files

4.9.3

6 files

4.9.2

6 files

4.9.1

6 files

4.9.0

4 files

4.8.2

6 files

4.8.1

4 files

4.8.0

6 files

4.7.8

6 files

4.7.7

6 files

4.7.6

6 files

4.7.5

6 files

4.7.3

6 files

4.7.2

6 files

4.7.1

4 files

4.7.0

4 files

4.6.0

6 files

4.5.1

6 files

4.5.0

4 files

4.4.22

6 files

4.4.21

4 files

4.4.20

6 files

4.4.19

6 files

4.4.18

6 files

4.4.17

6 files

4.4.16

6 files

4.4.15

6 files

4.4.13

6 files

4.4.12

6 files

4.4.11

4 files

4.4.10

6 files

4.4.9

4 files

4.4.8

4 files

4.4.7

4 files

4.4.6

4 files

4.4.5

4 files

4.4.2

4 files

4.4.0

4 files

4.3.7

6 files

4.3.6

4 files

4.3.5

4 files

4.3.4

6 files

4.3.3

2 files

4.3.2

2 files

4.2.1

1 file

4.1.4

1 file

4.1.3

1 file

4.1.2

1 file

4.1.0

1 file

4.0.11

1 file

4.0.10

1 file

4.0.7

1 file

4.0.6

1 file

4.0.5

2 files

4.0.4

1 file

4.0.3

2 files

4.0.2

1 file

4.0.1

1 file

4.0.0

3 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page