Skip to main content

A Simple System Monitoring & Benchmarking Toolkit

Project description

Python package

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: guro-1.0.1.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.1.tar.gz
Algorithm Hash digest
SHA256 77bb34290021ee6e08f3915c9f7a0bd6ed91b621c6acb17fe988e558830bdd09
MD5 5d5e579c0a47cd9ca13f2734eaba1386
BLAKE2b-256 776e2e557ee1c7fe1a0f8d55447e853488ab75faecfc9cfc54433e5e6be33897

See more details on using hashes here.

File details

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

File metadata

  • Download URL: guro-1.0.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 846460dc848971df151d4420e5691412096194ecf1daf9dce61d52b08739f940
MD5 a72ec40fce02b56abe1c2630f8e3add7
BLAKE2b-256 bd56e3ce4478d4d38ca3fc3e7d9c2185e0758962a6f94e3ccc4eaac8d8e83dd4

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