systempi

Panel de monitoreo del sistema Raspberry Pi en tiempo real para terminales Linux con telemetría en vivo, análisis de salud del hardware y renderizado de bajo parpadeo.

---

CARACTERÍSTICAS

• Monitoreo en tiempo real de CPU, RAM, swap, disco y red
• Telemetría de hardware Raspberry Pi mediante vcgencmd
• Detección de alimentación, throttling, subtensión y limitación de frecuencia
• Puntuación dinámica de salud del sistema, salud del almacenamiento y estabilidad
• Diagnósticos dinámicos de explicabilidad "Health Why"
• Umbrales térmicos adaptados al modelo y puntuación de salud para múltiples generaciones de Raspberry Pi
• Mini-gráficos históricos de salud y temperatura, con tendencias ampliadas de CPU, RAM y red en modo Doctor
• Registro persistente de eventos de alerta con soporte de watch/history
• Detección ligera de alertas activas para CPU, RAM, disco, temperatura y eventos de alimentación/throttle de la Pi
• Inteligencia de hardware Raspberry Pi con filas de información de modelo/arquitectura/RAM/proceso principal
• Monitoreo de actualizaciones de paquetes en modo Doctor con comprobaciones responsivas del estado local de APT y comprobaciones opcionales de frescura de repositorios
• Monitoreo opcional de telemetría Raspberry Pi AI Hat+ / AI Hat+2 Hailo con métricas de carga de NPU, temperatura, memoria y utilización
• 15 temas integrados, incluidos matrix, wasteland, ocean, raspberrypi, mono, amber, crt, vaulttec, synthwave, ice, biohazard y más
• 4 variaciones de panel: Balanced, Compact, Minimal y Doctor
• Renderizador responsivo de redibujado parcial de terminal de bajo parpadeo con redimensionamiento dinámico de terminal
• Atajos de teclado, incluido q para salir instantáneamente del panel
• Escalado adaptativo del panel según el ancho de la terminal
• Visualización en vivo de CPU por núcleo, tasas de E/S de disco, rendimiento de red, carga media y tiempo de actividad

---

MODOS DE PANEL

Modo	Propósito
Balanced	Panel de monitoreo completo
Compact	Optimizado para terminales más pequeñas
Minimal	Modo limpio solo con lo esencial
Doctor	Modo de diagnóstico, alertas y monitoreo de actualizaciones

Cada variación está diseñada para un flujo de trabajo de monitoreo diferente — desde el monitoreo mínimo ligero hasta el análisis de diagnóstico profundo.

---

CAPTURAS DE PANTALLA / TEMAS

Modo Balanced — Panel principal

systempi --variation balanced --theme raspberrypi

Nota: --variant y --var también pueden usarse como alias de --variation.

---

Modo Doctor — Diagnóstico, Alertas e Información del Sistema

systempi --variation doctor --repo-check --theme vaulttec

---

Modo compacto — Optimizado para terminales más pequeñas

systempi --variation compact --theme crt

---

Modo mínimo — Monitoreo limpio esencial

systempi --variation minimal --theme ice

---

Tema Wasteland

systempi --variation balanced --theme wasteland

---

Tema Biohazard

systempi --variation doctor --theme biohazard

---

Tema Ocean

systempi --variation balanced --theme ocean

---

Tema Synthwave

systempi --variation doctor --theme synthwave

---

INSTALACIÓN

git clone https://github.com/WastelandSYS/systempi.git
cd systempi
chmod +x install.sh uninstall.sh
sudo ./install.sh

Iniciar con:

systempi

DESINSTALACIÓN

cd systempi
sudo ./uninstall.sh

Limpieza de dependencias opcionales:

sudo ./uninstall.sh --remove-deps

El desinstalador elimina el acceso directo global systempi de /usr/local/bin. No elimina tu carpeta de repositorio clonada.

---

USO / Variaciones

Lanzamiento predeterminado:

systempi

Presione q en cualquier momento para salir del panel en vivo.

Modo de instantánea única (renderizar una vez y salir):

systempi --once

Modo compacto:

systempi --variation compact

Modo mínimo:

systempi --variation minimal

Modo equilibrado:

systempi --variation balanced

Modo Doctor (enfocado en diagnóstico):

systempi --variation doctor

Modo Doctor con comprobación opcional de actualización del repositorio:

systempi --variation doctor --repo-check

El modo Doctor actualiza su recuento normal de Updates cuando cambia el estado local de los paquetes. El recuento sigue proviniendo de apt list --upgradable; SystemPi solo utiliza los cambios de estado de los paquetes como desencadenante para volver a consultar a APT. Esto no requiere acceso sudo/root y no instala, elimina ni actualiza paquetes.

--repo-check es opcional y solo es válido con el modo Doctor. Contacta con los repositorios APT ya configurados en la máquina, almacena metadatos aislados propiedad del usuario en ~/.cache/systempi/apt/ y se actualiza de forma asíncrona cada tres horas sin modificar la caché APT del sistema.

Updates significa las actualizaciones conocidas actualmente por los metadatos APT normales de la máquina. Repo significa el resultado de la comprobación opcional de frescura del repositorio privado de SystemPi. Por ejemplo, Updates 8 available y Repo 9 available significa que el sistema conoce actualmente 8 actualizaciones disponibles, mientras que la comprobación aislada del repositorio ve 9 paquetes disponibles en total.

Una vez + exportar instantánea:

systempi --once --export text --output report.txt
systempi --once --export json --output report.json

Registro de eventos de alertas en vivo con soporte de watch/history:

systempi --watch
systempi --history

--watch registra eventos de alerta recién activados, y --history imprime eventos recientes desde:

~/.local/state/systempi/events.log

Ejemplos de selección de tema:

systempi --theme ocean
systempi --theme matrix
systempi --theme wasteland

Ejemplos de intervalo de actualización:

systempi --refresh 0.5
systempi --refresh 2

Fijar las métricas de red a una interfaz específica:

systempi --interface eth0
systempi --interface wlan0