pysaeco 0.1.0

Library and CLI for communicating with Saeco-family coffee machines over BLE, with MQTT discovery for Home Assistant.

pysaeco

pysaeco is an early-stage Python library and CLI for communicating with Saeco-family coffee machines over Bluetooth LE.

It uses bleak for cross-platform BLE support and can emit Home Assistant MQTT discovery payloads.

Install for development

uv sync --extra dev

CLI

uv run pysaeco-server

By default the server scans for BLE machines, publishes MQTT/Home Assistant discovery to localhost:1883, and serves the HTTP API/status page at http://127.0.0.1:8080.

Library sketch

from pysaeco import SaecoClient
from pysaeco.avanti import Espresso

with SaecoClient("AA:BB:CC:DD:EE:FF", pin=1234) as client:
    status = client.read_status()
    client.brew(Espresso(coffee_ml=45))

Development notes

• Keep BLE client details in pysaeco.client.
• Keep Avanti protocol packets, responses, recipes, and parsed status in pysaeco.avanti.
• Put Home Assistant discovery entities in pysaeco.homeassistant.discovery.