gbeng

Pretty-print the GB electricity generation mix in your terminal.

Data comes from the free, unauthenticated NESO Carbon Intensity API. No API key needed.

Install

pip install gbeng

Or with uv:

uv tool install gbeng

Note that if you use uv you don't even need to install it, just run uvx!

Usage

Print current mix and exit:

gbeng mix

Live display (refreshes every 2 seconds, re-fetches data every 5 minutes):

gbeng mix --live

Example output

╭─ GB Electricity Grid ────────────────────────────────────────────╮
│ Carbon intensity: 142 gCO₂/kWh (moderate)                        │
│                                                                   │
│          Generation mix                                           │
│  Fuel      Share                                                  │
│  wind      35.2%  ███████████████████████████████████            │
│  gas       28.1%  ████████████████████████████                   │
│  nuclear   20.0%  ████████████████████                           │
│  solar      8.5%  ████████                                        │
│  imports    5.0%  █████                                           │
│  hydro      2.1%  ██                                              │
│  biomass    1.1%  █                                               │
│                                                                   │
│  Fetched 2026-04-23 12:34:56 · data from api.carbonintensity.org.uk · ^C  │
╰───────────────────────────────────────────────────────────────────╯

Development

git clone https://github.com/phalt/gb-energy-mix-cli
cd gb-energy-mix-cli
make install
make test

Licence

MIT