Skip to main content

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

Project description

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

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

Python package OpenSSF Scorecard CodeQL Advanced PyPI version PyPI Downloads License: MIT GitHub Stars Buy Me A Coffee


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.


Visual Presentation

1. Performance Telemetry View

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

2. Hardware Thermal Schematic

Thermal Heatmap 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.


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.

Community and Development

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

  • 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: Buy Me A Coffee

Star History

Star History Chart


Developed with ❤️ by Dhanush Kandhan.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

guro-1.1.3.tar.gz (25.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

guro-1.1.3-py3-none-any.whl (19.5 kB view details)

Uploaded Python 3

File details

Details for the file guro-1.1.3.tar.gz.

File metadata

  • Download URL: guro-1.1.3.tar.gz
  • Upload date:
  • Size: 25.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.11

File hashes

Hashes for guro-1.1.3.tar.gz
Algorithm Hash digest
SHA256 0d2236419d131bddd69afa899500962511b4d399bf1268e9da277b34b735783b
MD5 b3ce49a8229f63e1c4ffd6b783c9aa1a
BLAKE2b-256 4e6a3a59c7657b4eb337b649015f7815501bf8046e7780f8feb4875c421ce895

See more details on using hashes here.

File details

Details for the file guro-1.1.3-py3-none-any.whl.

File metadata

  • Download URL: guro-1.1.3-py3-none-any.whl
  • Upload date:
  • Size: 19.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.11

File hashes

Hashes for guro-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 d8d4381461257dcb6b62e786bde1aed9fe4e7d1304a9e430275422aeb2fe907d
MD5 63f9bf81d3810f6d444bff62bd2de12d
BLAKE2b-256 75ddb5afa88c7dd0512fc382cf5c7d3ccd6306ed4614e3d27fedfcca2b83999d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page