Skip to main content

A Simple System Monitoring & Benchmarking Toolkit

Project description

Python package OpenSSF Scorecard CodeQL Advanced PyPI Downloads

"Buy Me A Coffee"

Guro - A Simple System Monitoring & Benchmarking Toolkit 🚀

Welcome to Guro, the ultimate toolkit for system monitoring and benchmarking. It’s simple, fast, and designed for developers and enthusiasts who want to monitor system performance, run benchmarks, and visualize system heatmaps in an intuitive way.

Features:

  • 📊 Real-time system monitoring – Monitor CPU, memory, and disk usage in real-time.
  • 🔥 Performance benchmarking – Run benchmarks with mini and full-scale tests for your CPU and GPU.
  • 🌡️ Hardware heatmap – Visualize your system's temperature with a heatmap in real-time.
  • 💾 Export data – Export monitoring data to CSV for analysis.

Installation

For General Installation:

pip install guro

For Linux & MacOS users, we recommend installing via pipx for better isolation or use can virtual environments:

pipx install guro

For Windows users, use a virtual environment to manage the CLI-based package:

python -m venv guro_env
source guro_env/bin/activate  # On Windows: guro_env\Scripts\activate
pip install guro

Usage

Run the following commands for monitoring, benchmarking, or heatmap analysis:

1. Monitor System Resources

guro monitor --interval 1.0 --duration 60
  • Options:
    • --interval/-i: Monitoring interval in seconds (default: 1.0).
    • --duration/-d: Monitoring duration in seconds.
    • --export/-e: Export monitoring data to a CSV file.

2. Run Benchmark Tests

guro benchmark --type mini --cpu-only
  • Options:
    • --type/-t: Type of benchmark test to run (mini or god).
    • --cpu-only: Run only CPU benchmark.
    • --gpu-only: Run only GPU benchmark.

3. Visualize System Heatmap

guro heatmap --interval 1.0 --duration 30
  • Options:
    • --interval/-i: Update interval in seconds (must be greater than 0.1).
    • --duration/-d: Duration to run in seconds (default: 10).

4. List All Commands

guro list
  • Displays all available commands and options for the toolkit.

5. About Guro

guro about
  • Displays information about Guro, including version, author, and features.

License

MIT License. See [LICENSE] for more details.

For more details, check out our [documentation].

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.0.2.tar.gz (21.1 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.0.2-py3-none-any.whl (16.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for guro-1.0.2.tar.gz
Algorithm Hash digest
SHA256 2be5e4ff7727ed64492dfa9dbbc5cae0c53fb07aa27172f034a5be145f0173c5
MD5 a71c1ba6004580ffb3bdfb788feec240
BLAKE2b-256 5037f1285b8b1ee7fb4818006e3bf975fa1444b4356e0bf3ea2d154355b09f70

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for guro-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b32a8d8518a01ed60a8b2953d3ead64f94df1123991ae5783239efcd588f248e
MD5 26c7d7f25190068de9c570e87a566da1
BLAKE2b-256 024e77c7f55900f12ee38226c6d324373f65aacd96001c96142a7a76766e6865

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