🎛️ microservicematrix

microservicematrix is a modular suite of Python-based microservices that collect, normalize, and publish data from various internet and local sources—designed for a 128×64 RGB LED matrix (Tidbyt-style) but decoupled for flexible display targets.

Extracted data is transformed and then published as update events via Redis Pub/Sub. Consumers like matrixclient and nodewebdisplay render the content in real time or generate static BMPs for testing and archival.

All services are containerized for Kubernetes deployment and are tightly integrated with:

• 🔑 secretmanager – secure, multi-source config management (available on PyPI)
• 🧩 MicroService – uniform abstraction for service logic and configuration

📋 Service Overview

Each service is a subclass of MicroService, and can run as a long-lived process or invoked in one-shot mode. Configuration is sourced via secretmanager and managed using Kubernetes secrets and YAML deployments.

* MLB polling logic:
At 11:30 AM EDT, the service checks the day's schedule. It then:

• Sleeps until the first game starts
• Polls every 30 seconds during games
• Sleeps again after the final game ends

🚀 Quick Start (Dev)

Each service will run politely from the commandline - writing to its configured database and pushing Redis updates (if desired).

git clone https://github.com/dekeyrej/microservicematrix
cd microservicematrix
# normal virtual environment tasks
python moon.py

To build and push the container images you can either modify the github/workflows for your environment, or use build.sh and builds.txt in the utilities folders. Build.sh reads builds.txt (which is simply a list of the services to build) and builds an image and pushes it to the registry of your choice.

Once pushed, the microservices can be deployed with:

kubectl apply -f yaml/

Secrets can be passed via secrets.json, .env, Kubernetes secrets, or AES-256 encrypted Kubernetes secrets Vault Transit decrypted - depending on your SecretManager configuration.

🌐 Related Repositories

• – Service abstraction layer and CLI-ready page system
• – Lightweight multi-backend data access and persistence
• – Unified API for secrets from env, file, or Kubernetes
• – RGB LED matrix renderer (hardware and BMP mode)
• – Frontend for live display via SSE/Redis
• – Homelab orchestration and provisioning roles/playbooks