RP4 + MicroPython + LVGL = ImportError: no module named 'lvgl'

klasik · January 12, 2026, 3:00pm

Hi,
I’m very new to RP and LVGL, so i need help
What i have:

RP4 with latest Raspberry Pi OS lite (Debian Trixie) installed
SPI display: waveshare 2.8 320x240 (ST7789 + ADS7846).

I’d like to evaluate LVGL and prototyping some GUI.
I have used this manual:

lvgl/lv_micropython/blob/master/README-LVGL.md

# Micropython + lvgl

**Micropython bindings to LVGL for Embedded devices, Unix and JavaScript**

[![Build lv_micropython unix port](https://github.com/lvgl/lv_micropython/actions/workflows/unix_port.yml/badge.svg)](https://github.com/lvgl/lv_micropython/actions/workflows/unix_port.yml)
[![Build lv_micropython stm32 port](https://github.com/lvgl/lv_micropython/actions/workflows/stm32_port.yml/badge.svg)](https://github.com/lvgl/lv_micropython/actions/workflows/stm32_port.yml)
[![esp32 port](https://github.com/lvgl/lv_micropython/actions/workflows/ports_esp32.yml/badge.svg)](https://github.com/lvgl/lv_micropython/actions/workflows/ports_esp32.yml) [![Build lv_micropython rp2 port](https://github.com/lvgl/lv_micropython/actions/workflows/rp2_port.yml/badge.svg)](https://github.com/lvgl/lv_micropython/actions/workflows/rp2_port.yml)
[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/lvgl/lv_micropython)  

To quickly run Micropython + LVGL from your web browser you can also use the [Online Simulator](https://sim.lvgl.io/).

**For information about Micropython lvgl bindings please refer to [lv_binding_micropython/README.md](https://github.com/lvgl/lv_binding_micropython/blob/master/README.md)**

See also [Micropython + LittlevGL](https://blog.lvgl.io/2019-02-20/micropython-bindings) blog post. (LittlevGL is LVGL's previous name.)  
For questions and discussions - please use the forum: https://forum.lvgl.io/c/micropython

Original micropython README: https://github.com/micropython/micropython/blob/master/README.md

## Relationship between `lv_micropython` and `lv_binding_micropython`

This file has been truncated. show original

I have successfully executed:

sudo apt-get install build-essential libreadline-dev libffi-dev git pkg-config libsdl2-2.0-0 libsdl2-dev python3.8 parallel
git clone GitHub - lvgl/lv_micropython: Micropython bindings to LVGL for Embedded devices, Unix and JavaScript
cd lv_micropython
git submodule update --init --recursive user_modules/lv_binding_micropython
make -C mpy-cross
make -C ports/unix submodules
make -C ports/unix

Then i trying to test it and it’s not working:
./build-standard/micropython

MicroPython v1.20.0-2510.gacfeb7b7e on 2026-01-12; linux [GCC 14.2.0] version
Use Ctrl-D to exit, Ctrl-E for paste mode

import lvgl as lv
Traceback (most recent call last):
File “”, line 1, in
ImportError: no module named ‘lvgl’

What’s wrong?

Ivan_Tarozzi · January 15, 2026, 6:29pm

For some reason the build intruction are wrong.
make -C ports/unix doesn’t compile the LVGL micropython. In facts you are calling build-standard/micropython.
I had sucess using this:

cd  ports/unix
make submodules
cd ../../scripts
./build-unix.sh

Then use the micropython executable you can find in /ports/unix/build-lvgl

klasik · January 19, 2026, 9:01am

God bless you! It works now!