TamaFi is an open-source, WiFi-enabled virtual pet project built with an ESP32-s3
TamaFi is an open-source, WiFi-enabled virtual pet project built with an ESP32-s3
Ready to dive deeper into TamaFi's details? Discover the full story, in-depth tutorials, and all the exciting features in our comprehensive documentation. Click the link and explore further!
TamaFi is a modern, WiFi-aware virtual pet.
V2 rebuilds the original project with new hardware, smarter logic, and a clean, compact PCB that actually feels like a finished device.
The pet lives on an ESP32-S3, eats nearby WiFi, evolves over time, and makes its own decisions based on the environment around it.
⚠️ Some advanced / sensitive behaviors are intentionally simplified or left as placeholders in the public firmware.
This project is for learning, tinkering, and fun — not for breaking things.
TamaFi isn’t just a sprite animation loop. It runs a small decision engine that constantly evaluates:
hunger, happiness, healthFrom that, it decides whether to:
The pet mood changes based on stats + environment:
HUNGRY – low hunger HAPPY – good stats + decent WiFi CURIOUS – hidden/open networks nearby BORED – no WiFi for too long SICK – low health or bad conditions EXCITED / CALM – good conditions & varietyMood affects:
Age is tracked in minutes, hours, and days:
BABY → TEEN → ADULT → ELDEREvolution depends on:
Reaching a new stage triggers special SFX + animations.
All rendering goes through a 240×240 framebuffer (TFT_eSPI + TFT_eSprite) to avoid flicker.
Idle, Hunting…, Resting…, etc.) Navigation is done using the left 3 buttons (UP / OK / DOWN).
Main Menu:
Changes in Controls/Settings are saved to NVS via Preferences, so they persist across reboots.
This is a summary of the V2 hardware stack.
Check thePCB/andSchematic/directories for full details.
The firmware is written for Arduino IDE using:
TFT_eSPI Adafruit_NeoPixel WiFi Preferencesmain.ino – hardware init, timers, logic tick, button handling ui.cpp / ui.h – rendering, menus, bar drawing, layout ui_anim.h – sprite frame tables for idle, egg, hunt, etc. sound – non-blocking retro sound sequencer using LEDc state – pet stats, traits, persistence with PreferencesThe code is structured around non-blocking updates:
nodelay()in the main logic, so animations, WiFi, sound, and UI can all coexist smoothly.
V2 is still under active development. Expect rough edges.
| Area | Status | Notes |
|---|---|---|
| Core stats | ✅ Stable | Hunger, happiness, health, age |
| Mood system | ✅ Stable | Driven by stats + WiFi environment |
| Evolution | ✅ Stable | Multi-stage, environment-aware |
| WiFi “feeding” | ✅ Stable | Logic works; tuning values ongoing |
| Rest system | ✅ Stable | Enter/exit animations + stat recovery |
| Hunt animation | ✅ Stable | Uses dedicated attack frames |
| Menus & UI | ⚠ In progress | Layout & styling still evolving |
| Sound engine | ✅ Stable | Non-blocking retro SFX |
| NeoPixel effects | ⚠ In progress | Mood + activity patterns, still tweaking |
| Desktop tooling | ⚠ Planned | Companion webapp / deeper integration |
Distributed under the MIT License. See LICENSE.txt for more information.
▶ Support me on Patreon patreon.com/cifertech
CiferTech - @twitter - [email protected]
Project Link: https://github.com/cifertech/TamaFi
The libraries and projects listed below are used in this software:
No open issues yet, or sync has not completed.