Micropython env for Sipeed Maix boards https://maixpy.sipeed.com
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
junhuanchen a3f708c9e3 [video] Don't configure I2S internally 3 days ago
assets/image add new framwork 1 year ago
components [video] Don't configure I2S internally 3 days ago
projects [Fix] M5stick lcd_init() for lcd.init() in _boot.py. 1 week ago
tools [temp fix] kpu.deinit() and gc.collect() are in conflict. 3 weeks ago
.gitignore add kmodel v4 support 6 months ago
.gitmodules update submodule 9 months ago
.travis.yml update ci 2 months ago
Kconfig update ci 2 months ago
LICENSE.md add new framwork 1 year ago
README.md update readme 1 month ago
README_ZH.md update readme 1 month ago
build.md update build script for toolchain set 1 month ago
requirements.txt add micropython compile script 1 year ago


<img src="https://travis-ci.org/sipeed/MaixPy.svg?branch=master" alt="Master branch build status" />

<img src="https://img.shields.io/badge/build-master-ff69b4.svg" alt="master build firmware" />

<img src="https://img.shields.io/github/release/sipeed/maixpy.svg" alt="Latest release version" />

<img src="https://img.shields.io/badge/license-Apache%20v2.0-orange.svg" alt="License" />

<img src="https://img.shields.io/github/issues/sipeed/maixpy/good%20first%20issue.svg" alt="Good first issues" />

<img src="https://img.shields.io/github/issues/sipeed/maixpy/bug.svg" alt="Bug issues" />

<img src="https://img.shields.io/github/issues/sipeed/maixpy/enhancement.svg" alt="Enhancement issues" />


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

MaixPy, makes AIOT easier!

Maixpy is designed to make AIOT programming easier, based on the Micropython syntax, running on a very powerful embedded AIOT chip K210.

K210 brief:

  • Image Recognition with hardware acceleration
  • Dual core with FPU
  • 8MB(6MB+2MB) RAM
  • 16MB external Flash
  • Max 800MHz CPU freq (see the dev board in detail, usually 400MHz)
  • Microphone array(8 mics)
  • Hardware AES SHA256
  • FPIOA (Periphrals can map to any pins)
  • Peripherals: I2C, SPI, I2S, WDT, TIMER, RTC, UART, GPIO etc.

There are many things you can do with MaixPy, please refer to here

Simple code

Find I2C devices:

from machine import I2C

i2c = I2C(I2C.I2C0, freq=100000, scl=28, sda=29)
devices = i2c.scan()

Take picture:

import sensor
import image
import lcd

while True:


See Releases page

Get latest commit firmware: master firmware

Custom your firmware, see build or use online custom tool


Doc refer to maixpy.sipeed.com



Build From Source

See build doc

The historic version see historic branch (No longer maintained, just keep commit history)

Use online compilation tools to customize firmware

Go to maixhub.com to use online compilation to customize the functions you need

Model hub: Maixhub.com

Find more models on Maixhub.com


See LICENSE file

Other: As C SDK for C developers

In addition to the source code of the MaixPy project, since MaixPy exists as a component, it can be configured to not participate in compilation, so this repository can also be developed as C SDK. For the usage details, see Building Documentation, which can be started by compiling and downloading projects/hello_world.

The compilation process is briefly as follows:

wget http://dl.cdn.sipeed.com/kendryte-toolchain-ubuntu-amd64-8.2.0-20190409.tar.xz
sudo tar -Jxvf kendryte-toolchain-ubuntu-amd64-8.2.0-20190409.tar.xz -C /opt
cd projects/hello_world
python3 project.py menuconfig
python3 project.py build
python3 project.py flash -B dan -b 1500000 -p /dev/ttyUSB0 -t