vallox-websocket-api

What it is and what it does

vallox-websocket-api is an async Python client for remote control and monitoring of Vallox ventilation units over WebSocket. It wraps the same API that Vallox's own web interface uses, allowing you to set operating profiles (Home, Away, Auto, Fireplace, Extra), adjust fan speeds and target temperatures, fetch real-time metrics like air temperatures and humidity, and retrieve historical logs stored on the device. The package requires Python 3.9.0+ and depends on websockets, construct, and aiohttp for async HTTP and binary protocol handling.

The library is designed for LAN-connected units running firmware 2.0.0 or newer. It has been tested on Vallox 145 MV and 270 MV models but claims compatibility with a broad range of Vallox, Airflow, and Helios ventilation units. Most metrics are read-only, but you can set profile-specific fan speeds, target temperatures, and timer values; unsettable addresses can be manually marked as settable if needed.

Use it for:

• Automate ventilation profile switching based on occupancy or time-of-day schedules in a smart home
• Monitor real-time temperature and air quality metrics from a Vallox unit in a monitoring dashboard
• Integrate ventilation control into a home automation framework that manages HVAC alongside other systems
• Retrieve and log historical temperature data from the unit for energy analysis or troubleshooting
• Adjust fan speeds and target temperatures remotely without accessing the unit's physical interface

Worth the install?

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

Async WebSocket client for controlling and monitoring Vallox ventilation units over LAN, supporting profile switching, fan speed adjustment, metric fetching, and temperature log retrieval.

Yes, if you own a compatible Vallox ventilation unit and need programmatic control. The package is actively maintained, has low install friction, and provides a complete async interface to the device's WebSocket API. The LGPL 3 copyleft license is a constraint only if you plan to distribute proprietary derivatives. No known security vulnerabilities. Verify your unit model is supported before committing.

Install

vallox-websocket-api on PyPI

pip install vallox-websocket-api

uv add vallox-websocket-api

poetry add vallox-websocket-api

Installing vallox-websocket-api

Before you install

Low install friction with pure-Python dependencies (websockets, construct, aiohttp). Actively maintained with recent releases; last commit 2026-07-20 and 35 days since latest release indicate ongoing development.

License in practice

Licensed under LGPL 3 (copyleft). Any derivative work or bundled distribution must also be open-source under compatible terms; proprietary applications cannot incorporate this code without releasing their own source.

Quickstart

import asyncio
from vallox_websocket_api import Vallox, Profile

client = Vallox('192.168.1.10')

async def run():
    data = await client.fetch_metric_data()
    await client.set_profile(Profile.HOME)

asyncio.run(run())

Requires Python 3.9.0 or newer. Vallox unit must be connected to LAN with firmware 2.0.0 or newer recommended.

Verify before relying

• Exact list of settable vs. read-only metrics beyond the documented examples
• Compatibility confirmation for all listed unit models (tested only on Vallox 145 MV and 270 MV)
• Behavior and error handling when unit is offline or unreachable

Package facts

Evidence: vallox_websocket_api-6.1.0-py3-none-any.whl

Keywords: vallox, api

Tags

More Networking packages