what is esp32-ecosystem-sim fr?

This project is a small artificial life simulation built to run on an ESP32 microcontroller connected to a 1.9 inch color screen. Once flashed onto the hardware, it draws a tiny self running ecosystem on the display, with no buttons or interaction needed. You just plug it in and watch plants, animals, and predators live out their lives on screen. The simulation models seven kinds of entities that form a food chain: plants that grow over time, herbivores that eat plants, carnivores that hunt herbivores, apex predators that hunt carnivores, spores that infect and eventually kill animals, corpses left behind by dead creatures, and decomposers that clean up corpses and spores and eventually turn them back into new plants. Each creature has simple physics and steering behavior, similar to flocking simulations, giving them a sense of movement and awareness of their surroundings. Entities also carry simple inherited traits. An altruism trait makes some herbivores share energy with weaker relatives and isolate themselves when infected. An immunity trait can block infections but costs more energy to maintain, which creates trade offs between individuals that survive disease outbreaks and individuals that breed more efficiently in calm times. A speed trait affects how fast a creature moves, trading escape ability against how easily it starves. As creatures survive and age, their on screen color shifts to show they are veterans. On the hardware side, the code uses the ESP32's two processor cores separately: one core runs the physics, collision checks, and creature behavior, while the other core is dedicated to drawing pixels to the screen over SPI. The project lists the exact display model and wiring pins needed, and explains how to install the required display library and flash the code using the Arduino IDE. A separate Python script is also included so you can test how the ecosystem behaves without needing the physical hardware. Running it simulates thousands of steps and produces a population graph using matplotlib, which is useful for checking whether the balance between plants, herbivores, and predators looks stable before flashing real hardware.