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

Known Vulnerabilities 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.

🌐 Website: guro.pages.dev


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.

  • 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: 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.4.tar.gz (27.3 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.4-py3-none-any.whl (21.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: guro-1.1.4.tar.gz
  • Upload date:
  • Size: 27.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for guro-1.1.4.tar.gz
Algorithm Hash digest
SHA256 ce98d8b90ebd4035d8694d35c33a13457743d3ac6d816c3a42d7d1cd155a5c25
MD5 8a6a711ac7d9b248a125e605edf810f8
BLAKE2b-256 ee5f9265017c7e73b438700507ea27349c5aa0a1032374c754cf9a40ed2b8f67

See more details on using hashes here.

Provenance

The following attestation bundles were made for guro-1.1.4.tar.gz:

Publisher: python-publish.yml on dhanushk-offl/guro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

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

File metadata

  • Download URL: guro-1.1.4-py3-none-any.whl
  • Upload date:
  • Size: 21.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for guro-1.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 4c1c46d1253c37c66cb1ee4883c5999ae71f31b9e066cec0d860bc9dc852c7c9
MD5 cc6a13a41db70e0f2d8abdb2e2d06c75
BLAKE2b-256 5ee1a98891764a79cf9935a75fb442c17dd5eeeaef9ac82db9305270056d0e45

See more details on using hashes here.

Provenance

The following attestation bundles were made for guro-1.1.4-py3-none-any.whl:

Publisher: python-publish.yml on dhanushk-offl/guro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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