mainboard 0.0.1

CPU, GPU, and NPU hardware topology and telemetry for Python.

Warning mainboard is early (0.0.x). The Python API is small on purpose, but provider details may still change.

Installation

pip install mainboard

Working in a chefe project? Add it to your manifest:

chefe add mainboard --pypi

On Linux with NVIDIA GPUs, pull the CUDA provider extra: pip install "mainboard[nvidia]".

What it is

mainboard tells Python what compute is on the current machine, without assuming the world is only CUDA. It models CPUs, GPUs, and NPUs as Units, keeps vendor-specific probing behind providers (Apple and NVIDIA today), and gives you the whole board in one call.

from mainboard import Machine

print(Machine().model_dump_json(indent=2))   # cpu, memory, gpus, npus, and the host environment

Usage

machine = Machine()
machine.cpu.snapshot()             # CPU identity and capacity
machine.gpus[0].snapshot()         # per-GPU telemetry
machine.environment                # user, group(s), and job scheduler on the host
machine.model_dump_json()          # one-call JSON probe of the whole machine

The CLI renders a Rich schematic of the board:

mainboard

Lore

A mainboard is where the silicon lives. This one just tells you what is plugged in.