Wokwi quick start

Who: You want to run pydisplay in the browser simulator without hardware or a local clone.

Prerequisites: A wokwi.com account (free).

Minimum project (recommended)

In-repo files: wokwi/minimum/

1. Create a new ESP32-S3 MicroPython project.
2. Copy main.py and diagram.json from wokwi/minimum/.
3. Start the simulation — hello.py should appear on the ILI9341 display.

Or open the hosted minimum project.

Full install project

wokwi/esp32-s3-full/ downloads and runs installer.py with the Wokwi board config. Hosted copy: 415770470006384641.

VS Code

See wokwi/README.md for the Wokwi VS Code extension and firmware setup.

Board configs used

Config	Touch
board_configs/busdisplay/spi/wokwi_ili9341_ft6x36_esp32s3	FT6X36
board_configs/busdisplay/spi/wokwi_ili9341_esp32s3_no_touch	None

Next

• ESP32 board guide — same steps on real hardware
• Try pydisplay — PyScript browser demo
• Wokwi details — hosted legacy projects, known issues

Reference

• API reference (core)