ESPHome Native API: Protobuf TCP Protocol on Port 6053

# Minimal — recommended for most devices
api:

# Full configuration with all options
api:
  port: 6053
  encryption:
    key: "YOUR_BASE64_ENCRYPTION_KEY_HERE"
  batch_delay: 100ms
  max_connections: 5
  reboot_timeout: 15min

api:
  encryption:
    key: "JpOu9bQJUUqz+3OHC9tSRDO5b3Vl2ZhXr5WekAoUP9Y="

pip install aioesphomeapi

import asyncio
import aioesphomeapi


async def main():
    # Connect to the device
    api = aioesphomeapi.APIClient(
        "living-room-sensor.local",
        6053,
        password=None,
        noise_psk="JpOu9bQJUUqz+3OHC9tSRDO5b3Vl2ZhXr5WekAoUP9Y=",  # omit if no encryption
    )

    await api.connect(login=True)

    # List all entities on the device
    entities, services = await api.list_entities_services()
    for entity in entities:
        print(f"Entity: {entity.name} ({entity.__class__.__name__})")

    # Subscribe to real-time state changes
    def on_state_change(state):
        print(f"State update: {state}")

    await api.subscribe_states(on_state_change)

    # Keep running and receiving updates
    await asyncio.sleep(30)
    await api.disconnect()


asyncio.run(main())

import asyncio
import aioesphomeapi


async def main():
    api = aioesphomeapi.APIClient("livingroom.local", 6053, password=None)
    await api.connect(login=True)

    # List entities to find the key for the light
    entities, _ = await api.list_entities_services()
    light_key = next(
        e.key for e in entities
        if hasattr(e, "name") and e.name == "Living Room Light"
    )

    # Turn the light on at 50% brightness
    await api.light_command(
        key=light_key,
        state=True,
        brightness=0.5,
    )

    await api.disconnect()


asyncio.run(main())

# By IP
aioesphomeapi-logs 192.168.1.100

# By IPv6 address
aioesphomeapi-logs fe80::cdef:0123:4567:89ab

# With encryption
aioesphomeapi-logs 192.168.1.100 --noise-psk <your-api-key>

api:
  on_client_connected:
    - logger.log:
        format: "Client %s connected from %s"
        args: ["client_info.c_str()", "client_address.c_str()"]

  on_client_disconnected:
    - logger.log: "A client disconnected from the API"

on_boot:
  - wait_until:
      condition:
        api.connected:
          state_subscription_only: true   # true = only count HA-style clients
  - logger.log: "Home Assistant is connected"
  - homeassistant.event:
      event: esphome.device_booted