Oreo mascot
Oreo
~15 minutes · USB-C + a computer

From box to badge, in four steps.

The deploy script handles version bumps, hash-cache pruning, free-space guards, and secrets generation. You hold the BOOT button, you wait, you tap A.

  1. 01

    Flash MicroPython

    Download the ESP32-S3 build, hold the BOOT button, flash via esptool. Two-minute job.

  2. 02

    Clone the OS

    `git clone https://github.com/elixpo/oreo` and copy `.env.example` → `.env` with your WiFi credentials.

  3. 03

    Deploy

    `python tools/deploy.py` — pushes everything over USB, skips unchanged files, bumps the version.

  4. 04

    Open the badge

    Drawer → Settings → WiFi → Send files. Cloudflare-served `/upload` works from any phone on the same WiFi.

MicroPython firmware

ESP32-S3 build matching your flash size.

mpremote

Talks to the badge over USB serial.

Repo

Source, schematics, CHANGELOG.

Need help?

Open an issue with your serial-console log (mpremote connect /dev/ttyACM0 repl) — the project's print breadcrumbs make most boot failures diagnosable in one round trip.