MicroPixel

English | 简体中文

MicroPixel runs WebAssembly apps on Espressif microcontrollers. Apps use a C++23 SDK for graphics, input, audio, storage, and sensors, without depending on a board-specific SDK. The firmware manages hardware, app isolation, and the system UI.

Hardware

The Host uses ESP-IDF 6.1 and a pinned WAMR fork. Apps are compiled to architecture-specific AOT v6 bundles. The ABI is still evolving.

Build an app

Install the SDK and connect a device running MicroPixel firmware. App development does not require ESP-IDF.

micropixel init my-app --app-id com.example.my-app --title "My App"
cd my-app
micropixel --transport usb run

run builds, installs, starts the app, and follows its logs. Ctrl-C stops log streaming; the app keeps running. See the quickstart and publishing guide.

Build the firmware

Initialize submodules, activate ESP-IDF 6.1, and configure WASI SDK and the matching MicroPixel WAMRC. See the build guide (Chinese) for toolchain setup and flashing.

git submodule update --init --recursive
python3 -m pip install -r requirements-dev.txt
bash tools/p4.sh build-host

Other profiles: bash tools/s31.sh build-host, bash tools/s3.sh build-host <box3|szpi|cores3|watcher> and python3 tools/firmware.py <ksdiy-p4c5|ksdiy-p4c5-landscape> build.

Project

• Guest SDK — app APIs and examples.
• Firmware — Host runtime and board support.
• Documentation — architecture, protocols, and development guides.
• Contributing.

License

Project-authored code, documentation, and assets use Apache-2.0, unless stated otherwise. See third-party notices for dependency licenses and exceptions.