myPyllant

What it is and what it does

myPyllant is an async Python client for the undocumented myVAILLANT API, letting you programmatically control and query Vaillant heating systems and their branded variants (MiGo, Glow-worm). It wraps aiohttp and pydantic to handle authentication, system discovery, and device operations like temperature setpoints, holiday modes, and hot water boosts. The library is reverse-engineered from the official app and not affiliated with Vaillant; the developers disclaim responsibility for device damage.

You can use it as a Python library in async code, or invoke it as a CLI tool to export system data and energy reports. It requires Python 3.10 and handles timezone-aware operations automatically. The package is actively maintained, with a small but engaged community and integration into Home Assistant.

Use it for:

• Export system configuration and historical data from your Vaillant heating setup for analysis or backup.
• Automate temperature adjustments and holiday schedules programmatically from a home automation platform.
• Generate annual energy reports for each heat generator in your system.
• Monitor and control domestic hot water boost and setpoint temperature remotely.
• Build a custom Home Assistant integration or other home automation bridge to Vaillant devices.

Worth the install?

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

A Python library for interacting with the myVAILLANT app API to control and monitor Vaillant heating systems and their branded variants.

Yes, if you own a Vaillant system and need programmatic control or data export. The library is actively maintained, has low install friction, carries no security vulnerabilities, and is permissively licensed. The main caveat is that it reverse-engineers an undocumented API, so Vaillant could break it at any time; the developers explicitly disclaim responsibility for device damage. Test thoroughly in a non-critical environment first.

Install

mypyllant on PyPI

pip install mypyllant

uv add mypyllant

poetry add mypyllant

Installing myPyllant

Before you install

Low friction installation with a pure-Python wheel. The package is actively maintained with a recent release (23 days old) and steady repository activity. Requires Python 3.10 or later.

License in practice

Licensed under MIT (permissive), allowing commercial and private use with minimal restrictions.

Quickstart

pip install myPyllant

import asyncio
from myPyllant.api import MyPyllantAPI

async def main():
    async with MyPyllantAPI(user, password, brand, country) as api:
        async for system in api.get_systems():
            print(system)

asyncio.run(main())

Requires Python 3.10 or later. On Windows and systems without a timezone database, also install tzdata.

Verify before relying

• Whether the library works reliably with all branded variants (MiGo, Glow-worm) or only certain configurations.
• API stability and rate limits when making frequent requests to the myVAILLANT backend.
• Whether account credentials are safely handled and what security practices are recommended.

Package facts

Evidence: mypyllant-0.9.18-py3-none-any.whl

Tags

More WWW/HTTP packages