esphomeesphomeOfficial·1 Agent Skills Included

aioesphomeapi

Python client for controlling ESPHome smart home devices

Connects Python applications to ESPHome smart home devices over the native API protocol. Handles encrypted Noise connections, protobuf messaging, and Bluetooth data without manual socket programming. Powers the Home Assistant ESPHome integration and any custom automation that needs fast, reliable device control.
npx skills add esphome/aioesphomeapi --all -g -y
Available:

Gives your AI agent the project conventions, build rules, and Cython pitfalls it must follow when editing or submitting changes to this Python client library.

All Skills in This Repository (1)

Pure Emerald Level Indicators

Frequently Asked Questions

FAQPage Schema
How to install aioesphomeapi?

Run `npx skills add esphome/aioesphomeapi --all -g -y` in your terminal to install all skills in this repository globally.

What is aioesphomeapi used for?

It is the official asyncio Python client for the ESPHome native API, letting Python programs discover, connect to, and control ESPHome-flashed smart home devices.

Does aioesphomeapi support encrypted connections?

Yes. It supports both plaintext and Noise-encrypted (Noise_NNpsk0_25519_ChaChaPoly_SHA256) connections to ESPHome devices over TCP.

Is aioesphomeapi used by Home Assistant?

Yes. The Home Assistant ESPHome integration is built directly on this library to communicate with ESPHome devices.

Can I contribute changes to the API protocol?

Protocol changes must land in the esphome/esphome firmware repository first, then the matching client change is submitted here with a linked pull request.

Related Repositories in Software Engineering

View All in Software Engineering