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.
/ capabilities
Cross-platform. Linux, macOS, and Windows. Desktop-class diagnostics inside your terminal — no GUI required.
High-frequency ASCII-based historic trending. Real-time CPU core utilization, memory envelopes, and active process telemetry in a rich TUI dashboard.
Regex-free data acquisition from lm-sensors and WMI.
Spatial temperature mapping across integrated hardware with synchronized trend analysis.
Safety-first high-load stability testing with thermal threshold awareness. Full support for NVIDIA, AMD, and integrated GPU solutions.
Comprehensive GPU status reporting with memory usage, temperature, utilization, and driver version across all detected graphics hardware.
/ commands
Access all capabilities through a unified interface. No flags to memorize — just run.
/ installation
Two ways to install. Pick your preference.
/ contributing
Guro follows professional development standards. Here's everything you need to get involved.
git clone https://github.com/dhanushk-offl/guro.gitpython -m venv venv && source venv/bin/activatepip install -e ".[test]"
rich.live to minimize flickering.
unittest.mock
to simulate hardware environments for CI/CD compatibility.
python -m pytest tests/
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.