electrickiwi-api

What it is and what it does

electrickiwi-api is an async Python client for the Electric Kiwi energy provider API, built on aiohttp. It wraps Electric Kiwi's HTTP endpoints to let you query and manage your account data—active sessions, connection details, and related state—without managing tokens or sessions yourself (you provide the auth implementation). The package is minimal by design: it handles the API calls but leaves authentication, session management, and token lifecycle to you, assuming you'll use an existing library or framework for those concerns.

The package requires Python 3.13 or later and depends only on aiohttp. You implement the AbstractAuth interface to supply credentials, then pass it to ElectricKiwiApi and make async calls. After retrieving your session, you must call set_active_session() to store your customer number and connection ID on the client instance, which subsequent API calls then use automatically.

Use it for:

• Query your Electric Kiwi account status and active session details in an async Python application.
• Automate energy usage monitoring or billing checks by calling the Electric Kiwi API from a scheduled task.
• Build a dashboard or reporting tool that pulls real-time account data from Electric Kiwi.
• Integrate Electric Kiwi account management into a larger async application or service.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Async Python client for the Electric Kiwi API that provides a simple interface to query and manage Electric Kiwi energy account data using basic authentication.

Yes, if you are an Electric Kiwi customer building an async Python application and need direct API access. The package is actively maintained, has low install friction, and requires only aiohttp. However, the GPL-3.0-only license means any derivative work must also be GPL-3.0-only, and the low star count and small user base suggest limited real-world validation. Verify that the API coverage meets your needs before committing.

Install

electrickiwi-api on PyPI

pip install electrickiwi-api

uv add electrickiwi-api

poetry add electrickiwi-api

Installing electrickiwi-api

Before you install

Low install friction with a single async dependency (aiohttp). Actively maintained with recent releases; last commit 2026-08-04. Requires Python 3.13 or later.

License in practice

Licensed under GPL-3.0-only (copyleft). Any derivative work or distribution must also be released under GPL-3.0-only; proprietary use is not permitted.

Quickstart

pip install electrickiwi-api

from electrickiwi_api import ElectricKiwiApi

api = ElectricKiwiApi(auth_impl)
await api.get_active_session()
await api.set_active_session()

Requires Python 3.13 or later. You must implement AbstractAuth to handle authentication before passing it to ElectricKiwiApi.

Verify before relying

• Whether the package is suitable for production use given its low star count (1) and small download volume.
• Scope and completeness of the Electric Kiwi API coverage—which endpoints are supported.
• Whether session/token management responsibility on the caller is a practical constraint for typical use cases.

Package facts

Evidence: electrickiwi_api-0.10.1-py3-none-any.whl

Tags

More WWW/HTTP packages