---
id: pyatag
version: "0.3.7.1"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# pyatag — Python module to talk to Atag One.

License: permissive · Maintenance: dormant · Downloads: 73.8K/mo

## What it is and what it does

PyAtag is an async Python library for communicating with Atag One heating systems. It provides a high-level interface to discover, authorize with, and control Atag One devices on your network, reading sensor data and climate settings and issuing commands like temperature adjustments. The library is built on asyncio and aiohttp, making it suitable for integration into async home-automation frameworks.

The package has a single runtime dependency (aiohttp) and installs with low friction. However, maintenance is dormant—the last commit was 2024-03-20 and the latest release was 2023-10-09—so it receives no active updates or bug fixes. It is suitable only if you have an Atag One device and are willing to maintain or fork the code yourself if issues arise.

Use it for:

- Integrate Atag One heating control into a home-automation platform using async Python.
- Build a custom async script to monitor and adjust heating settings remotely.
- Discover and query Atag One devices on your local network for status reporting.
- Automate temperature adjustments based on external conditions or schedules.

## Worth the install?

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

Asynchronous Python library for controlling Atag One heating systems over the network using asyncio and aiohttp.

Yes, if you own an Atag One device and need async Python control. The library is straightforward, has low install friction, and carries no known vulnerabilities. However, be aware that maintenance is dormant—no updates since 2024-03-20—so treat it as stable-but-unsupported; fork or maintain it yourself if you encounter issues.

## Install

pip install pyatag
uv add pyatag
poetry add pyatag

## Installing pyatag

Before you install: Low install friction with a single runtime dependency (aiohttp). Maintenance is dormant—last commit was 2024-03-20 and the latest release was 2023-10-09—so expect no active bug fixes or feature updates.

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

Quickstart:

pip install pyatag

import asyncio
import aiohttp
from pyatag import AtagOne
from pyatag.discovery import async_discover_atag

async def main():
    async with aiohttp.ClientSession() as session:
        atag_ip, atag_id = await async_discover_atag()
        atag = AtagOne(atag_ip, session)
        await atag.authorize()
        await atag.update()
        await atag.climate.set_temp(20)

asyncio.run(main())

Requires Python 3.x and network access to an Atag One device; auto-discovery requires UDP broadcast access (typically hostnet mode in containers).

Verify before relying:

- Whether the package works with current Atag One firmware versions given the dormant maintenance status.
- Compatibility with modern aiohttp versions beyond what the fact sheet documents.

## Package facts

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

## Tags

atag one control library, heating system async control, atag boiler python, asyncio home heating, atag device integration, home-automation, async-io, device-control

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