ha-async-patterns

What problem does it solve?

Home Assistant runs on a single-threaded asyncio event loop. All I/O operations must be non-blocking. Blocking the event loop freezes the entire system — automations stop, the UI becomes unresponsive, and entities stop updating.

Core Features & Use Cases

• Async Libraries: use async-native libraries such as aiohttp to perform non-blocking I/O.
• Wrapping Sync Calls: when no async library exists, run blocking I/O in executor via hass.async_add_executor_job.
• Setup Patterns: implement async_setup_entry and async_unload_entry to ensure safe async setup and teardown.

Quick Start

To begin, ensure your integration uses async_setup_entry and avoids blocking I/O.