hardware // bill of materials // assembly

THE BUILD

One dev board does almost everything โ€” screen, touch, Wi-Fi, BLE, SD, audio amp โ€” so the "build" is closer to assembly than electronics. No soldering.

Bill of materials

PartSpec~CostWhere
Waveshare ESP32-S3-Touch-LCD-2.8ST7789 240ร—320 IPS ยท 5-pt CST328 touch ยท I2S amp + volume dial ยท SD slot ยท Wi-Fi/BLE ยท speakers included in the kit$35amazon ยท waveshare
Battery (optional)MakerFocus 3.7V 2000 mAh 1S LiPo (103450) w/ protection board, JST 1.25 โ€” fits under the board inside the case$22 / 4-packamazon
microSD cardany 8 GB+, FAT32 โ€” holds her face & sound pack; the default Hermes CRT pack ships in the repo, and a community Pack Exchange is on the roadmap$6anywhere
Brass standoffs + M2.5 bolts4ร— standoffs raise the board for battery clearance; M2.5 bolts secure the case bottom$8amazon link soon
USB-C cabledata-capable, to your gateway machineโ€”your drawer
Case comingsnap-fit 3D-printable landscape stand โ€” CAD + Bambu 3MF will live in the repo. No printer? A print-on-demand button is plannedfilamentthis site

Assembly

  • 1. Flash the firmware โ€” from your browser on the FLASH page (WebSerial, Chrome/Edge), or with PlatformIO from the repo
  • 2. Load the SD card โ€” copy the hermes-buddy/ asset pack (face animations, sounds) to a FAT32 card, insert
  • 3. Plug a speaker โ€” the kit's included speaker goes straight into the board's speaker jack; set the on-board volume dial to taste
  • 4. Battery (optional) โ€” the LiPo plugs into the BAT connector and tucks under the board; four brass standoffs give it clearance inside the case
  • 5. Case โ€” snap-fit print, M2.5 bolts on the bottom
  • 6. USB into your gateway machine โ€” the plugin finds her automatically on any port
  • 7. Install the plugin โ€” one command, see PLUGIN; Wi-Fi credentials are provisioned over USB, no SD editing

Orientation: she sits landscape, USB exiting to the side. If the screen comes up inverted for your stand, rotation is a one-line config over USB โ€” never a reflash.

The board, briefly

ESP32-S3 (240 MHz dual-core, 8 MB flash), 2.8" IPS at 240ร—320 driven through LovyanGFX, CST328 capacitive touch, I2S mono amplifier to the speaker jack, SD over SDMMC, native USB-CDC serial. The familiar uses USB as its control channel and Wi-Fi only to pull audio โ€” so it works fully even on a network-less bench, just silently.