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.2.tar.gz (25.4 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.2-py3-none-any.whl (19.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: guro-1.1.2.tar.gz
  • Upload date:
  • Size: 25.4 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.2.tar.gz
Algorithm Hash digest
SHA256 b7d0eb4b36fa26051594d92f47310c5097e055dec8e1f2cf5733b660b050b24e
MD5 d4f3906273fa2328230dfa8e0eb1757f
BLAKE2b-256 d0c371d93e07ffb1a5829b125b6993a7babadaf5ff815c98bbb2d3e2570d4a91

See more details on using hashes here.

File details

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

File metadata

  • Download URL: guro-1.1.2-py3-none-any.whl
  • Upload date:
  • Size: 19.4 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9d79dc20e1b73f4860523f91accd0e3e61a71125a6b61eb779fc261750bd5d1c
MD5 970f6085730c0316767e638fe340b785
BLAKE2b-256 aee30042f1edbbf0ee48208d9968651b145258b1afd86c55fa1bf45b395b3d91

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