guro 1.1.6

A System Tool-kit for Real-time Monitoring and Analysis

Guro: A System Tool-kit for Real-time Monitoring and Analysis

Professional real-time monitoring, thermal analysis, and hardware benchmarking.

---

Overview

Guro is a sophisticated terminal-based diagnostic toolkit designed for granular system resource monitoring and hardware analysis. Built for engineers and enthusiasts, it provides a desktop-class dashboard experience within the command-line environment, delivering precise telemetry across Linux, macOS, and Windows.

🌐 Website: guro.pages.dev

---

Visual Presentation

1. Performance Telemetry View

High-concurrency monitoring of CPU cores, memory allocation, and active process telemetry

2. Hardware Thermal Schematic

Spatial temperature mapping across integrated hardware components with synchronized trend analysis.

---

Key Capabilities

Intelligent Monitoring

The performance module utilizes high-frequency sampling to provide real-time ASCII-based historic trending. It offers a comprehensive view of system load including individual core utilization and physical/virtual memory envelopes.

Thermal Intelligence

Guro implements a robust, regex-free data acquisition layer for hardware sensors. By interfacing directly with lm-sensors on Linux and WMI on Windows, it provides reliable thermal mapping even across diverse kernel and driver versions.

Hardware-Agnostic Benchmarking

The benchmarking suite is designed with hardware safety as a priority. It ensures system stability by monitoring thermal thresholds during heavy load tests. It features full awareness for NVIDIA, AMD, and Integrated graphics solutions.

Network Intelligence

Real-time bandwidth monitoring with per-interface upload/download sparklines, TCP state distribution (ESTABLISHED, LISTEN, TIME_WAIT, etc.), process-level connection tracking, and /proc/net/snmp protocol statistics — all with zero additional dependencies beyond psutil.

---

Installation

Standard Method

pip install guro

Isolated Environment (Recommended)

pipx install guro

---

Operational Interface

Access Guro via its unified command-line interface.

Module	Command	Description
Monitor	guro monitor	Launches the interactive system performance dashboard.
Thermal	guro heatmap	Initiates spatial hardware heatmapping and trend analysis.
Graphics	guro gpu	Executes a diagnostic status report for all detected GPUs.
Bench	guro benchmark	Performs high-load system stability and speed testing.
Network	guro network	Real-time dashboard: bandwidth, adapters, TCP states, connections.
	guro network --speed	Snapshot of current upload/download speeds on all interfaces.
	guro network --interfaces	List all network adapters with IP, MAC, speed, and duplex.
	guro network --connections	Show active TCP connections with process names and states.

---

Roadmap

🚀 Coming soon — PRs, ideas, and discussions are warmly welcomed!

Area	Description
GPU Benchmarking 🎮	⚠️ NEEDS CONTRIBUTORS! — Native CUDA benchmarks for NVIDIA GPUs: compute performance, memory bandwidth, and thermal profiling. Want to help?
Network Diagnostics 🌐	✅ Done — Live dashboard with bandwidth sparklines, adapter specs, TCP state analysis, and active connection tracking.
Storage I/O 💾	Real-time disk throughput, IOPS, and queue-depth monitoring for server environments.

Have a feature in mind? Open an issue or start a discussion — every idea counts.

💖 Why Funding Matters

Testing system-level tooling demands real hardware — high-end GPUs, multi-CPU servers, and diverse cloud VMs for cross-platform validation. Your support helps rent these environments so Guro can be tested thoroughly across Linux, macOS, and Windows.

---

Community and Development

Guro is an open-source project that adheres to professional development standards.

• Website: guro.pages.dev
• Developer Guide: Comprehensive guidelines can be found in CONTRIBUTING.md.
• Architecture: In-depth module analysis is available in the project documentation.
• License: Released under the MIT License.
• Support: GitHub Sponsors · Buy Me A Coffee

Star History

---

Developed with ❤️ by Dhanush Kandhan.