---
id: millheater
version: "0.15.0"
license: MIT
license_treatment: permissive
maintenance: aging
---

# millheater — A python3 library to communicate with Mill

License: permissive · Maintenance: aging · Downloads: 74.1K/mo

## What it is and what it does

millheater is a Python 3 library that communicates with Mill heater devices over the network to send control commands and retrieve temperature readings. It wraps Mill's API using aiohttp for async HTTP requests and PyJWT for authentication, making it suitable for integrating Mill heaters into home automation systems or custom control applications.

The library is actively used in Home Assistant's Mill climate component. It targets modern Python (3.10+) and offers a low-friction installation as a pure-wheel package. Maintenance is aging—the last commit was recent but development activity appears limited—so you should expect slower response to bug reports or feature requests.

Use it for:

- Integrate Mill heaters into a Home Assistant or other home automation platform
- Build a custom dashboard to monitor and control multiple Mill heater devices remotely
- Automate heating schedules by querying current temperatures and adjusting device settings
- Log heater telemetry and temperature data for analysis or historical tracking

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python library to control Mill heater devices and read their measured temperatures via network communication.

Yes, if you own Mill heater devices and need programmatic control or temperature monitoring. The library is stable, has no known vulnerabilities, and is already proven in Home Assistant. The aging maintenance status means you should not expect rapid updates, but the core functionality is solid for its narrow use case.

## Install

pip install millheater
uv add millheater
poetry add millheater

## Installing millheater

Before you install: Low install friction with a pure-Python wheel. Maintenance status is aging—last commit was 2025-12-11 and the repository remains active but shows limited recent development velocity.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart:

pip install millheater

import millheater
# Create client and authenticate with Mill API credentials
# Use aiohttp-based async methods to control heaters and fetch temperatures

Requires Python 3.10 or later; uses async/await patterns via aiohttp, so callers must run within an async context.

Verify before relying:

- Specific Mill device models or API versions supported by version 0.15.0
- Whether PyJWT is used for authentication or token handling with Mill's API
- Rate limits or throttling behavior when polling multiple heater devices

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 74.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mill heater control python, smart heater api library, home automation heating, mill device integration, temperature monitoring heater, iot heater control, mill climate device, home-automation, iot-device, async-http

[View on SkillFed](https://skillfed.io/packages/millheater) · [View on PyPI](https://pypi.org/project/millheater/)