How-To Series · Episode 33 / 59 · Module 5: Everywhere You Are

Hermes · In Home Assistant

Ask your house what's going on. Tell it what to do.

After this videoYou can now wire Hermes into your smart home.

The Home Assistant integration is two things from one token: smart-home tools that query and control devices, and a gateway platform that reacts to real-time device events. Create a Long-Lived Access Token in HA, set HASS_TOKEN (and HASS_URL if non-default), and hermes gateway. Four tools (ha_list_entities, ha_get_state, ha_list_services, ha_call_service) let you talk in plain language. Reactive events need watch_domains or watch_entities set, nothing forwards by default. Dangerous service domains are blocked, and replies arrive as HA persistent notifications.

About these resources. Every command in this video comes from the Home Assistant integration doc.

Sources · What this video distills

1 docs page · every command below traces to one of them
Primary · tools + gateway model, HASS_TOKEN/HASS_URL, the four ha_* tools, event filtering, blocked domains
Home Assistant Integration
Read ↗

Commands shown · Copy and paste

each shows the source doc it came from
Required env (~/.hermes/.env)from source ↗
HASS_TOKEN=your-long-lived-access-token
Optional HA URLfrom source ↗
HASS_URL=http://192.168.1.100:8123
hermes gateway
Reactive events (config.yaml)from source ↗
platforms.homeassistant.extra.watch_domains: [climate, binary_sensor, light]

Going deeper · Related Hermes docs

further reading · not sources of facts shown above

Next in the series · Episodes that build on this

E34
Webhooks
E36
Schedule With Cron
E40
Event Hooks