Skip to content
MCU Atlas
ESP32ESP32-S3Draft

TamaFi: Wi-Fi-eating virtual pet on ESP32-S3

A Tamagotchi-style pet on an ESP32-S3 with a color TFT that eats nearby Wi-Fi networks to stay healthy.

Difficulty:IntermediateCost:Source available

Photos

TamaFi: Wi-Fi-eating virtual pet on ESP32-S3 photo 1

Photos: cifertech/TamaFi

Key Facts

  • Chip: ESP32-S3
  • Display: 240x240 ST7789 TFT
  • Mechanic: passive Wi-Fi scan feeds the pet
  • Build: custom PCB (V2)

About This Project

TamaFi is a modern take on the virtual pet. The creature lives on an ESP32-S3 with a 240x240 ST7789 screen, and nearby Wi-Fi networks (scanned passively) affect its hunger, happiness and health. Version 2 adds a compact custom PCB and an autonomous behaviour engine where the pet hunts, rests and evolves. A fun desk toy and a gentle intro to Wi-Fi scanning and sprite graphics.

Source & Attribution

Source: GitHub
License: MIT
Last verified: 10/16/2026
TamaFi: Wi-Fi-eating virtual pet on ESP32-S3
How to Build It
TamaFi is a Tamagotchi-style virtual pet that feeds on nearby Wi-Fi. An ESP32-S3 scans the networks around it, and the results drive the pet's hunger, happiness and health. It evolves, changes mood, and shows sprites on a 240x240 TFT, with NeoPixel mood lighting. V2 runs on a compact custom PCB.
Draft: steps not yet verified

Parts Needed

  • ESP32-S3 (or the TamaFi V2 PCB)
  • ST7789 240x240 TFT
  • Push buttons
  • LiPo battery
  • 4x WS2812-2020 NeoPixels (on the V2 PCB)
  • USB data cable

Steps

  1. 1

    Get the hardware

    Order the V2 PCB from the repo's hardware files, or breadboard an ESP32-S3 with an ST7789 display, buttons and NeoPixels, following the pin mapping in the docs.

  2. 2

    Install the Arduino IDE

    Add the ESP32 board package and the display and NeoPixel libraries listed in the documentation.

  3. 3

    Open and configure

    Open the firmware sketch. Check the pin definitions match your build and select an ESP32-S3 board with USB CDC enabled.

  4. 4

    Upload

    Upload over the S3's native USB, or through the optional CP2102 on the V2 board.

  5. 5

    Raise your pet

    Hatch the egg, then 'hunt' to feed it on nearby Wi-Fi. Leaving it without networks makes it bored. Its stats and evolution stage are saved in flash between power cycles.

Parts List (BOM)
Parts list inferred by MCU Atlas — check the original
inferred
PartQtyRoleEst. PriceBuy
1main board$10–$18View
1display$3–$8View
3buttons$1–$3View
1power$4–$10View
Estimated Total$16–$35 USD

Not included: 3D-printed case, wire, solder, USB cable

Download CSV

Related Projects

Watchy: open-source ESP32 e-ink smartwatch
Illustration
ESP32Draft
An open-source smartwatch with a 1.54in e-paper screen and ESP32, hackable watch faces in Arduino.
Beginner·Under $15·Code
2 parts listed
Low-power ESP32 e-paper weather display (7.5in)
Illustration
ESP32Draft
A wall-mounted 7.5in e-paper weather display on an ESP32 that runs for months on one battery charge.
Intermediate·Cost varies·Code
5 parts listed
OpenEPaperLink: reuse e-ink shelf labels with an ESP32 access point
Illustration
ESP32ESP32-S3Draft
Turns cheap second-hand electronic shelf labels into a Wi-Fi-managed e-ink display fleet via an ESP32 access point.
Advanced·Under $15·Code
3 parts listed