pyre — setup

documentation

pyre overview

Mac system monitoring CLI — CPU, memory, GPU, disk, battery, thermal, network, P2P streaming, web dashboard, benchmarking.

features

▸Real-time Dashboard — interactive TUI with mouse support, graphs, and custom panel layouts
▸Zero Sudo Required — native SMC sensor caching and system APIs provide temperatures and power metrics
▸P2P & Remote Fleet — encrypted TCP telemetry streaming or multi-Mac monitoring via pyre fleet
▸History & Benchmarking — CSV logging, historical trends, snapshot diff, CPU benchmark

quick start

# interactive live dashboard
pyre live

# static snapshot
pyre --once

# web dashboard on localhost
pyre web --port 3000

temperature monitoring

Pyre reads CPU/GPU/SMC die temperatures via macOS powermetrics. This requires passwordless sudo. Without it, pyre falls back to less precise sensor sources.

Run once to grant access — no other elevated privileges are granted:

# allow powermetrics without password
echo "$(whoami) ALL=(root) NOPASSWD: /usr/bin/powermetrics" \
  | sudo tee /etc/sudoers.d/pyre-powermetrics

Why? powermetrics reads Apple SMC hardware sensors. Without this entry, readings can differ from btop by ~30 °C.

To remove later: sudo rm /etc/sudoers.d/pyre-powermetrics

visuals

pick a theme

Applied on first launch. Change anytime with c in the dashboard.

default

dracula

cyberpunk

mono

nord

gruvbox

defaults

configure live mode

Maps to pyre CLI flags. You'll get the exact command on the next screen.

parameters

refresh interval 2s export directory

toggles

auto-start CSV logging

Begin writing a continuous CSV log when live mode starts

detailed sensors by default

Show the full per-sensor thermal breakdown

p2p server

peer-to-peer streaming

Configure the server, then connect from another machine using the command below.

server settings

password ••••••••

bind address 0.0.0.0

port 9876

client command

pyre p2p connect \
  --p2p-host <server-ip> \
  --p2p-port 9876 \
  --p2p-password mysecret

Both machines must be on the same local network. Never expose this server to the public internet.

ready

launch configuration

Copy the commands below to start pyre with your settings.

live dashboard

pyre live --interval 2 --export-dir ./pyre-exports

Theme (default) applied via --theme — change anytime with c

p2p server

pyre p2p server --p2p-host 0.0.0.0 --p2p-port 9876 --p2p-password mysecret

Clients connect with: pyre p2p connect --p2p-host <server-ip> --p2p-port 9876 --p2p-password mysecret

shell aliases (optional)

echo 'alias pyre-live="pyre live --interval 2 --export-dir ./pyre-exports"' >> ~/.zshrc
echo 'alias pyre-p2p="pyre p2p server --p2p-host 0.0.0.0 --p2p-port 9876 --p2p-password mysecret"' >> ~/.zshrc

checklist

○ Sensor access command run

○ Theme selected: default

○ Refresh interval: 2s

○ Export directory: ./pyre-exports

○ P2P password set