uk-energy (Python)

Typed Python clients for the UK's public electricity data APIs. Mirrors the TypeScript packages in the same repo.

pip install uk-energy

Contains BMRS data © Elexon Limited copyright and database right 2026. Contains NESO Data Portal data, used under the NESO Open Data Licence. Carbon Intensity data © National Energy System Operator, CC BY 4.0.

See the repo README for the full attribution and licence notes.

Packages

from uk_energy.core import HttpClient, MemoryCache, RateLimit

elexon = HttpClient(
    "https://data.elexon.co.uk/bmrs/api/v1",
    rate_limit=RateLimit(5, burst=10),
    cache=MemoryCache(),
    cache_ttl_s=60,
)
fuel = elexon.get("datasets/FUELINST", {"publishDateTimeFrom": "2026-10-20T00:00Z"})

from uk_energy.carbon_intensity import CarbonIntensityClient

ci = CarbonIntensityClient()
ci.intensity_current()["intensity"]  # {"forecast": 125, "actual": 134, "index": "moderate"}
ci.regional_for_postcode("M1")["data"][0]  # region 3, North West England
ci.intensity_forward48h("2026-10-15T00:00Z")  # 97 half-hour periods

Note: intensity_for_date() uses a local GB day (BST in summer), and range endpoints include the period containing from_; see the TypeScript package README for the full list.

Development

cd python
uv sync
uv run pytest            # fixtures only, no network
UK_ENERGY_LIVE=1 uv run pytest -m live
uv run ruff check . && uv run mypy