---
id: vallox-websocket-api
version: "6.1.0"
license: LGPL 3
license_treatment: copyleft
maintenance: active
---

# vallox-websocket-api — Vallox WebSocket API

License: copyleft · Maintenance: active · Downloads: 73.7K/mo

## 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 above — 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

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

- License: LGPL 3 (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 73.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vallox ventilation control, websocket ventilation api, async hvac unit control, vallox metrics monitoring, ventilation unit remote api, vallox fan speed control, indoor air quality monitoring, hvac-control, home-automation, async-io

[View on SkillFed](https://skillfed.io/packages/vallox-websocket-api) · [View on PyPI](https://pypi.org/project/vallox-websocket-api/)