📝 Tamagotchi in Streamlit

🐾 Tamagotchi Web App – Practicing OOP and Interactive UI in Python

This project is a web-based Tamagotchi game I built using Python and Streamlit. The goal was to create a fun and interactive way to apply concepts of Object-Oriented Programming (OOP), build an event-driven UI, and manage stateful logic within a lightweight web framework.

🎯 Project Goals

• Practice OOP design by creating a class-based virtual pet

• Implement a modular and scalable architecture using separate files for logic, config, and visuals

• Use Streamlit to create an interactive, browser-based interface

• Learn to manage user state (st.session_state) to simulate memory and game persistence

• Deploy a project that is both technical and accessible

🧠 What I Built

• A Tamagotchi class with attributes like hunger, boredom, tiredness, and dirtiness

• Methods like .eat(), .play(), .sleeping(), and .bath() that affect pet status

• A death() method that ends the game if any parameter reaches 10

• A rock-paper-scissors mini-game to reduce boredom, fully playable with buttons

• Dynamic stats visualized with Plotly charts

• A message screen that shows real-time feedback and actions

• Support for game-over handling and restarting the game

• A separate Instructions page built with Streamlit's multi-page support

🛠️ Tools & Tech

• Python 3.10

• Streamlit for web UI

• Plotly Express for interactive visualizations

• Pandas for handling time-series-like game history

• HTML + Markdown for layout styling

📸 Screenshots

🔍 What I Learned

This project helped me reinforce:

• OOP design patterns (attributes, encapsulation, methods)

• How to design a modular Python project with clean structure

• Managing UI state in Streamlit without a backend

• Interactive game logic with immediate feedback to the user

• Basic frontend experience (icons, layout, user flow)

🌐 Why It Matters

Although Tamagotchi isn't a Data Science project directly, it demonstrates my ability to:

• Build maintainable, interactive Python applications

• Think in terms of user experience and workflow

• Apply programming principles in a creative and engaging way

• Work with Streamlit, a tool I also use for Data Science dashboards and apps

🚀 Live Demo & Code

• GitHub Repo: github.com/mgalvaro/tamagotchi

• Live Demo: https://tamagotchi-amg.streamlit.app/