devices-npu

README

devices-npu

Neural processing unit information for the devices-* family. NPUs are young hardware with young interfaces, so this category is detection-first: it reliably answers does this machine have an NPU and which one, and reports utilization where a real source exists rather than inventing one. Windows + Linux, no cgo required.

	basic	detailed	full
static	presence, name (Intel AI Boost / AMD XDNA / …), driver, accel node	PCI address, PnP device ID	—
dynamic	utilization on Linux (intel_vpu busy-time counter)	utilization on Windows ("NPU Engine" perf counters, Win11 24H2+)	—

Sources: the DRM accel class (/sys/class/accel) and ghw's PCI accelerator scan on Linux; PnP enumeration via WMI and typeperf on Windows. Machines whose driver exposes no counter get a gap naming the missing piece, not a fake zero.

$ devices-npu                 # is there one, and what is it
$ devices-npu --every 0.5     # utilization where supported
$ devices-npu web :8080

MIT — see LICENSE.

Documentation

Overview

Command devices-npu reports neural processor presence, identity, and utilization using the shared devices-common CLI: one-shot, --json, --every 0.25, --tui, --web.