Home
Softono
systempi

systempi

Open source Python
GitHub
61
Stars
7
Forks
0
Issues
1
Watchers
1 week
Last Commit
System Monitoring Terminal & CLI Tools

About systempi

Modern real-time Raspberry Pi system monitoring dashboard with live telemetry, hardware health diagnostics, and low-flicker terminal rendering.

Platforms

Web Self-hosted Linux

Languages

Python

Links

Source Code
w
Published by
wastelandsys
Visit View Profile

README.md

View on GitHub
SystemPI Tool Banner

systempi

Real-time Raspberry Pi system monitoring dashboard for Linux terminals with live telemetry, hardware health analysis, and low-flicker rendering.

FEATURES

  • Real-time CPU, RAM, swap, disk, and network monitoring
  • Raspberry Pi hardware telemetry through vcgencmd
  • Power, throttling, undervoltage, and frequency-capping detection
  • Dynamic system health, storage health, and stability scoring
  • Dynamic "Health Why" explainability diagnostics
  • Model-aware thermal thresholds and health scoring for multiple Raspberry Pi generations
  • Historical mini-graphs for health and temperature, with expanded CPU, RAM, and network trends in Doctor mode
  • Persistent alert event logging with watch/history support
  • Lightweight active alert detection for CPU, RAM, disk, temperature, and Pi power/throttle events
  • Raspberry Pi hardware intelligence with model/arch/RAM/top-process insight rows
  • Doctor mode package update availability monitoring with non-blocking background checks
  • Optional Raspberry Pi AI Hat+ / AI Hat+2 Hailo telemetry monitoring with NPU load, temperature, memory, and utilization metrics
  • 14 built-in themes including matrix, wasteland, ocean, raspberrypi, mono, amber, crt, vaulttec, synthwave, ice, biohazard, and more
  • 4 dashboard variations: Balanced, Compact, Minimal, and Doctor
  • Responsive low-flicker partial terminal redraw renderer with dynamic terminal resizing
  • Keyboard shortcuts including q for instant dashboard exit
  • Adaptive dashboard scaling based on terminal width
  • Live per-core CPU visualization, disk I/O rates, network throughput, load average, and uptime

DASHBOARD MODES

Mode Purpose
Balanced Full monitoring dashboard
Compact Smaller terminal optimized
Minimal Essential-only clean mode
Doctor Diagnostic, alert, and update-monitoring mode

Each variation is designed for a different monitoring workflow — from lightweight minimal monitoring to deep diagnostic analysis.

SCREENSHOTS / THEMES

Balanced Mode — Main Dashboard

systempi --variation balanced --theme wasteland
Note: --variant and --var may also be used as aliases for --variation.

SystempiBalancedWastelandV2 1 1

Doctor Mode — Diagnostic, Alert & System Insight

systempi --variation doctor --theme vaulttec

SystempiDoctorVaulttecV2 1 1

Compact Mode — Smaller Terminal Optimized

systempi --variation compact --theme crt

SystempiCompactCrtV2 1 1

Minimal Mode — Essential Clean Monitoring

systempi --variation minimal --theme ice

SystempiMinimalIceV2 1 1

Raspberrypi Theme

systempi --theme raspberrypi

SystempiBalancedRaspberrypiV2 1 1

Biohazard Theme

systempi --variation doctor --theme biohazard

SystempiDoctorBiohazardV2 1 1

Ocean Theme

systempi --theme ocean

SystempiBalancedOceanV2 1 1

Synthwave Theme

systempi --theme synthwave

SystempiBalancedSynthwaveV2 1 1

INSTALLATION

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

Launch with:

systempi

UNINSTALLATION

cd systempi
sudo ./uninstall.sh

Optional dependency cleanup:

sudo ./uninstall.sh --remove-deps

The uninstaller removes the global systempi shortcut from /usr/local/bin. It does not delete your cloned repository folder.

USAGE / Variations

Default launch:

systempi

Press q at any time to exit the live dashboard.

One-shot snapshot mode (render once and exit):

systempi --once

Compact mode:

systempi --variation compact

Minimal mode:

systempi --variation minimal

Balanced mode:

systempi --variation balanced

Doctor mode (diagnostic-focused):

systempi --variation doctor

Once + export snapshot:

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

Live alert event logging with watch/history support:

systempi --watch
systempi --history

--watch records newly active alert events, and --history prints recent events from:

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

Theme selection examples:

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

Refresh interval examples:

systempi --refresh 0.5
systempi --refresh 2

Pin network metrics to a specific interface:

systempi --interface eth0
systempi --interface wlan0

Disable ANSI colors:

systempi --no-color

Combine options:

systempi --variation compact --theme mono --refresh 2 --interface wlan0 --no-color

Help menu:

systempi -h

AVAILABLE THEMES

  • default
  • matrix
  • ocean
  • wasteland
  • lava
  • mono
  • girly
  • amber
  • crt
  • vaulttec
  • synthwave
  • ice
  • biohazard
  • raspberrypi

COMPATIBILITY

Designed primarily for Linux systems.

Tested on:

  • Raspberry Pi OS
  • Kali Linux ARM
  • Raspberry Pi 4B
  • Raspberry Pi 5

Notes:

  • Raspberry Pi hardware metrics require vcgencmd.
  • General system metrics require psutil, which is installed by install.sh.
  • Raspberry Pi AI Hat+ / AI Hat+2 telemetry is automatically detected when the Hailo software stack and hailortcli are available.

  • Non-Raspberry Pi systems can still provide standard CPU, memory, disk, and network metrics, but Pi-specific temperature, frequency, and throttling telemetry may show as unavailable.

WHY SYSTEMPI?

systempi was built to make Raspberry Pi monitoring feel modern, responsive, and visually enjoyable instead of cluttered or outdated.

The dashboard focuses on:

  • fast live telemetry
  • clean terminal aesthetics
  • low-flicker rendering
  • meaningful hardware insight
  • responsive layouts across terminal sizes

LICENSE

Systempi is released under the GNU General Public License v3.0. See LICENSE for the full license text.

AUTHOR

WastelandSYS