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.6-cp313-cp313-manylinux2014_x86_64.whl (4.1 MB view details)

Uploaded CPython 3.13

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

Uploaded CPython 3.12

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

Uploaded CPython 3.11

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

Uploaded CPython 3.10

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

Uploaded CPython 3.9

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

Uploaded CPython 3.8

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

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for maixpy-4.11.6-cp313-cp313-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 a386547b7485e899109665835d4eff0992489c2072a7f0a06b0e9a65fb8e1709
MD5 bb81dcda6ce3842a5ace3e895c47917f
BLAKE2b-256 e855762592d992c26576218dbf99b5d3c29a2d81423ed72cd263836df3586076

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for maixpy-4.11.6-cp312-cp312-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 09d013f03622cd17b16b8909f80970ceeae827900bea2b4dbf6dac5effc5f3c7
MD5 16e7210f661d748e60721e0a0012a4d5
BLAKE2b-256 82dfad793753e7d92f4fdfa4ef065a4c39d346b6df66163267fe80c937d9db4a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for maixpy-4.11.6-cp311-cp311-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 bf305d432e7b1a5f3dec0db4ec6bc282d9ac185fb8d625b2e1977aa2f2312c77
MD5 fb327cfa8f8842cb881062f41be02668
BLAKE2b-256 8d52f3ca048d00c555db5256c0bf9238da8cf3f62b899deb22c6055d028c9e30

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for maixpy-4.11.6-cp310-cp310-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 8682453b633928d1e8d44b31dbef69ed3e5a37af287720b7aa0597ee1eb68331
MD5 d1534826fe08c89ffeea0c06c8a19621
BLAKE2b-256 b80cd8abb5e982e2b02fb9464af3c36fe7e5d32e64ffae5c8a82bee70edeec16

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for maixpy-4.11.6-cp39-cp39-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 3d53d1ff1a27acd8f312aaeed34ed436fc32ddbf6efc090fdce8b45ab6627d57
MD5 157f6bb2258634ac2891aea6b0bfdb80
BLAKE2b-256 97caa53d593e71a1223938bef4e516fa1bdc76a53091b0eafbff527e7289ee11

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for maixpy-4.11.6-cp38-cp38-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 323389fc4a8534bb06ff0d1dd377f3251e8da9f080fa19ab4bd9883541da718e
MD5 69d74ce7ddcd97d80fddc9992e45bb9b
BLAKE2b-256 9d0083db218b8ba5c9c13eb593dbcc4dce630235c8e3ff74cadb4d093d4d4863

See more details on using hashes here.

File details

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

File metadata

  • Download URL: MaixPy-4.11.6-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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 73c4f533d61745152b0594f37a81a40924b5b27b1919d37ce600007ed4ff163d
MD5 9217e70cf539a7efd40c4a61620ca4db
BLAKE2b-256 61799139d7a6975ab643a7250d3d300aec7d4816c22ae9ab7a87db7a75ace958

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

4.11.8

7 files

4.11.7

7 files

This release

4.11.6 This release

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