open source · python · terminal

System
Monitor.

Guro is a sophisticated terminal-based diagnostic toolkit for granular resource monitoring, thermal analysis, and hardware benchmarking — built for engineers who live in the CLI.

GitHub Stars
Forks
Latest Version
Downloads/mo

Built for the
command line.

Cross-platform. Linux, macOS, and Windows. Desktop-class diagnostics inside your terminal — no GUI required.

📊
Performance Telemetry

High-frequency ASCII-based historic trending. Real-time CPU core utilization, memory envelopes, and active process telemetry in a rich TUI dashboard.

🌡️
Thermal Intelligence

Regex-free data acquisition from lm-sensors and WMI. Spatial temperature mapping across integrated hardware with synchronized trend analysis.

Hardware Benchmarking

Safety-first high-load stability testing with thermal threshold awareness. Full support for NVIDIA, AMD, and integrated GPU solutions.

🖥️
GPU Diagnostics

Comprehensive GPU status reporting with memory usage, temperature, utilization, and driver version across all detected graphics hardware.

One CLI,
everything you need.

Access all capabilities through a unified interface. No flags to memorize — just run.

guro monitor
Performance Dashboard
Interactive real-time system monitoring with CPU, memory, and process views.
guro heatmap
Thermal Heatmap
Spatial hardware temperature mapping with historical trend analysis.
guro gpu
GPU Diagnostics
Full diagnostic status report for all detected graphics processing units.
guro benchmark
System Benchmark
High-load stability and speed testing with thermal safety monitoring.

Up and running
in seconds.

Two ways to install. Pick your preference.

Standard pip
$ pip install guro
Isolated (Recommended) pipx
$ pipx install guro
PyPI Download Statistics live from pypistats.org fetching…
Today
This Week
This Month
This Year (2026)

Star History

Watch Guro grow — community momentum, one star at a time.

Help build
the future of Guro.

Guro follows professional development standards. Here's everything you need to get involved.

01 — SETUP
Development Environment
Clone the repo and create an isolated virtual environment before making changes.

git clone https://github.com/dhanushk-offl/guro.git
python -m venv venv && source venv/bin/activate
pip install -e ".[test]"
02 — STANDARDS
Architectural Guidelines
Keep core logic (monitoring, benchmarking) decoupled from the CLI interface. Subprocess calls must handle exceptions gracefully and prefer regex-free parsing. TUI updates should use rich.live to minimize flickering.
03 — TESTING
Testing Standards
All PRs must include relevant unit or integration tests. Use unittest.mock to simulate hardware environments for CI/CD compatibility.

python -m pytest tests/
04 — PROCESS
Pull Request Process
Create a feature branch from main. Use imperative commit messages. Ensure PEP 8 compliance and all tests pass before opening a PR. Update docs if you modify the public API or behavior.
  

Buy Dhanush a coffee

Guro is built and maintained solo, with ❤️ from Dhanush Kandhan. If it's saved you time, made your debugging sessions easier, or just lives in your muscle memory — consider buying a coffee to keep the project alive.