Frequently asked questions.

The simplest way is via pip:

pip install guro

For a cleaner global install on Linux/macOS, use pipx:

pipx install guro

On Windows, use a virtual environment:

python -m venv guro_env
guro_env\Scripts\activate
pip install guro

No. Most features run as a normal user. The only exception is the first-time sensors-detect setup on Linux, which needs sudo — that's a one-time system configuration, not Guro itself.

Python 3.8 or newer. Guro uses only standard modern Python — no legacy compatibility hacks.

Yes. CPU and memory monitoring work fully inside containers and VMs. Thermal sensors and GPU access depend on whether the host exposes those to the container. For bare-metal data, run Guro directly on the host.

Just run:

guro monitor

This starts an interactive dashboard. Use --interval to control sampling rate and --duration to set a time limit. Press Ctrl+C to stop at any time.

Pass the --export flag with a filename:

guro monitor --duration 120 --export session.csv

The CSV will contain timestamps alongside all sampled metrics for offline analysis.

mini is a quick sanity check — moderate load for a short duration, good for a fast performance snapshot.

god is maximum sustained load — designed to stress-test thermal limits, power delivery, and CPU/GPU stability over a longer period.

For benchmarks, yes — use --cpu-only or --gpu-only:

guro benchmark --type mini --cpu-only
guro benchmark --type god --gpu-only

For dedicated GPU diagnostics, use guro gpu which gives a full status report for all detected adapters.

guro list

This prints a formatted summary of every command and its options.

Guro supports Linux, macOS, and Windows. All core features work on all three platforms.

• Thermal heatmaps are best on Linux via lm-sensors
• Windows uses WMI for thermal data — no extra install needed
• macOS thermal readings are limited by OS restrictions

Install and configure lm-sensors:

sudo apt install lm-sensors
sudo sensors-detect

Run sensors after setup to verify your hardware is detected. Then try guro heatmap again.

Yes. Anywhere Python 3.8+ runs, Guro runs. ARM-based systems (Raspberry Pi, Apple Silicon via native Python, Jetson Nano) are fully supported. Some thermal sensors may differ by device.

• NVIDIA — Full support via nvidia-smi
• AMD — Supported via system sensors and ROCm where available
• Intel / Integrated — Basic diagnostics available

Yes. Guro is a standard PyPI package and works with any Python environment manager:

conda install pip && pip install guro   # conda
poetry add guro                          # Poetry
pipx install guro                        # pipx (recommended)

100% free and open source. Guro is released under the MIT License — use it commercially, fork it, embed it, no strings attached. See the full license.

Open an issue on GitHub Issues. For feature ideas, use GitHub Discussions.

Please include your OS, Python version, and the full error output when reporting bugs.

Read CONTRIBUTING.md for the full guide. In short: fork the repo, create a branch, make your changes, and open a pull request.

You can also support the project by starring it on GitHub or buying Dhanush a coffee ☕.

No. Guro is purely local. All data is read from your own hardware sensors and displayed in your terminal. Nothing is transmitted, stored in the cloud, or shared anywhere.