Eyeogotchi is a modular, extensible personal security tool for the Raspberry Pi Zero 2W that provides a unified platform for network awareness and defensive automation.

This project was inspired by the << Tamagotchi-like >> Pwnagotchi and Bjorn: Cyber Viking projects, with the intent of being used on the same hardware stack.

Clone the repo:

git clone https://github.com/z3r0-g/Eyeogotchi.git
cd Eyeogotchi

Run the installer:

scripts/install/install_eyeogotchi.sh
source ~/.bashrc

Start the service:

sudo systemctl start eyeogotchi

Open the Portal:

http://localhost

The CLI provides full control over configuration, extensions, logs, and runtime behavior.

eyeogotchi config
eyeogotchi extensions list
eyeogotchi extensions update
eyeogotchi extensions enable <name>
eyeogotchi extensions disable <name>
eyeogotchi restart
eyeogotchi logs

The real spirit of this project! The mascot reaction engine evaluates moods in strict priority order:

• concerned — system errors
• sweating — temperature > 60°C
• stressed — CPU > 80%
• annoyed — WiFi disconnected

• handshake → proud
• user_interaction → excited
• new_ap → curious

When bored too long:

• Enters detective mode for 600s
• Reads log lines
• Classifies them into moods
• Updates banners with noir narration
• Overrides ambient moods

• bored — idle > 300s
• curious — extended boredom triggers detective mode
• happy — light CPU load
• sleeping — idle > 120s
• sleeping — default fallback

Eyeogotchi extensions live in:

extensions/<extension_name>/

Each extension includes:

• extension.yaml — metadata, config, entrypoint
• service/main.py — plugin implementation
• api/routes.py — optional API endpoints
• renderer/ — optional UI components
• assets/ — optional static files

Extensions are:

• Auto‑discovered
• Auto‑loaded
• Auto‑registered with the API
• Configurable via extensions.yaml
• Auto-Installable from Git via extensions_sources

Eyogotchi was intended to be used as my own private security gateway for my laptop and/or local area network (depending on where it is plugged in). Beyond the platform, this includes extensions with the following functionality bundled:

• Gamified Display Renderer (for Waveshare 2.13 e‑ink)
• DNS Sinkhole (Safe Search, Ad Blocker, Secure Route)
• Network Endpoint Mapper (Know Thy Network Neighbors)
• Network Vulnerability Monitor (Know Thy Network Neighbors are Secure)

core/       → shared infrastructure (config, logging, event bus, runtime)
extensions/    → individual functional extensions
scripts/    → install, update, maintenance helpers
systemd/    → service unit templates
tests/      → unit + integration tests
web/        → API + Portal UI
cli/        → Eyeogotchi CLI tool

• Leightweight IPS (Local Area Network Sentry)
• LTE Monitor & Analytics (SIM7600G)
• Rayhunter Port/Integration for SIM7600G
• PiSugar UPS integration
• Bluetooth Tethering for UI/API Access
• AI‑driven Anomaly Detection (TinyLlama)
• Mesh Networking (include recognizing its pwnagotchi/bjorn cousins)

Eyeogotchi is designed to be hackable, modular, and fun — a personal security appliance you can extend, customize, and evolve.