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.5.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.5-py3-none-any.whl (21.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: guro-1.1.5.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.5.tar.gz
Algorithm Hash digest
SHA256 731dbbfbe505636c1eebb0b565bb75c0d7a5c80770b3bb9f99cfe96308f67e37
MD5 dfc1df14d01a7949aaffee1e332381d2
BLAKE2b-256 15d0198a53dafa7e8c363d559d62549c7c7b21c19c4c90cc72a53b0e105c3f19

See more details on using hashes here.

Provenance

The following attestation bundles were made for guro-1.1.5.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.5-py3-none-any.whl.

File metadata

  • Download URL: guro-1.1.5-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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 3348d5d767a211ad4b6dde39697b63a97b1d4f0a20958fb64411c76679c587ee
MD5 49ddea5aceed525c41c1942186b34682
BLAKE2b-256 d4ed2a46b83237b6e2d94d6643b7cf1a90077bd40b83660ec6101766df2251a4

See more details on using hashes here.

Provenance

The following attestation bundles were made for guro-1.1.5-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