Hermes Agent Home Assistant setup lets one AI agent watch your premises, answer questions about it and switch things on or off when you ask.
Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →
If you run a shop, a small office or a holiday let, that means fewer trips back to check the heating or the door.
If you would rather have my team point AI at the jobs that bring in customers, get your Backlink Gameplan today, or try Polar Rank free for 3 days.
This guide uses the official Nous Research instructions, rewritten for owners rather than engineers.
What this setup does for a business
Home Assistant is the free software that talks to your smart plugs, thermostats, sensors and locks.
Hermes Agent is an open-source AI agent from Nous Research that can run on your own computer or server.
The official plugin joins them, so the agent can see device states and control them.
You talk to it from the chat apps you already use, and it reports back in the same place.
Three jobs owners give it first
- Opening check: lights on, heating set, alarm off, all in one message.
- Closing check: is every door shut, is the alarm armed, are the locks engaged?
- Alerts: tell me when the back door opens after hours, or when the freezer sensor reads warm.
The docs include a sample security check that lists door sensors, reads the alarm panel, checks locks and sends one summary.
What you need before you start
- Home Assistant already running with your devices added.
- Hermes Agent installed on a machine that can reach Home Assistant on your network.
- Ten minutes and admin access to both.
Step 1: add the plugin to Hermes
Ask whoever looks after your tech to run one command: hermes plugins install homeassistant.
It comes from the official plugin catalog and the code is public in the hermes-official-plugins repo.
Step 2: make a key in Home Assistant
Open Home Assistant, click your name, find Long-Lived Access Tokens and create one called Hermes Agent.
Copy it straight away, because Home Assistant shows it once.
This key is what lets the agent in, so store it like a password.
Step 3: tell Hermes the key and the address
The key goes into a settings file called .env as HASS_TOKEN.
If Home Assistant does not live at the default address, add HASS_URL with the right one, such as http://192.168.1.100:8123.
Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →
Add HASS_HOME_CHANNEL with your phone's notify name if you want scheduled reports pushed to your phone.
🔥 Want an AI agent that runs more than the lights? Inside the AI Profit Boardroom you get step-by-step video trainings, the installable Agent OS, four coaching calls a week and 3,400+ members comparing builds. → Join the AI Profit Boardroom
Step 4: choose what the agent should watch
This step matters more than any other.
Out of the box, the agent receives no device events at all.
You choose which kinds of device it hears about, for example climate, door and window sensors, and the alarm panel.
That keeps it focused and stops a busy sensor from spamming it every few seconds.
There is a built-in 30-second cooldown per device as well.
Step 5: switch it on
Start the Hermes gateway and Home Assistant appears as a connected platform.
From then on, a sentence like "is the shop secure?" turns into real checks on real sensors.
What it can and cannot do
| It can | It cannot |
|---|---|
| List devices by type or room | Run shell scripts on the Home Assistant box |
| Read a device's full state | Use add-on controls or shut down the host |
| Change lights, climate, covers, media and fans | Send web requests from the HA server |
| Push notes into the HA notification panel | Act on events you have not told it to watch |
Those blocks are built into the plugin, which is a sensible default for a business setting.
Scheduled reports without lifting a finger
Hermes has scheduled jobs you can set up in plain language.
Point one at Home Assistant and it can send a 7am premises summary to your phone every day.
The line deliver: homeassistant:mobile_app_my_phone tells it where to send the report.
Risks to think about first
- Keep the token private and give it only to the agent.
- Start with watching, not controlling, until you trust the results.
- Locks and alarms deserve a confirmation step; ask your installer to keep those manual at first.
- If the agent goes quiet, the usual cause is the watch list being empty.
Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →
📞 Is your website bringing in as many customers as your building can handle? Get your Backlink Gameplan and get a plan for search, AI answers and local visibility built around your business, or try Polar Rank free for 3 days. Backlink Gameplan or try Polar Rank free for 3 days
How to tell it is working
Ask it to list every light in one room.
If it answers with names and states, the connection is live.
If it says it cannot reach Home Assistant, the address or key is wrong, and a fresh long-lived key fixes most cases.
The docs give a quick curl test that should reply "API running" when the address and key are right.
Worked example: a small café
Picture a café with smart plugs on the coffee machines, a thermostat, a fridge sensor and a door contact on the back entrance.
The owner wants three things: machines warm before opening, a fridge alert, and a check that the back door is shut at close.
The watch list covers climate, binary_sensor and the fridge sensor's entity, and nothing else.
At 6am a scheduled job switches the machine plugs on and confirms it in one message.
If the fridge reading climbs, the agent hears the change and sends a short warning to the manager's phone.
At close, a staff member types "lock-up check" and gets back a list of anything still open.
None of this needs new hardware beyond what Home Assistant already runs.
Worked example: a holiday let
A short-stay rental has a smart lock, heating, and window sensors.
Before a guest arrives, the owner asks the agent to set the heating and confirm every window reads closed.
After checkout, a second check confirms the heating is back down and the lock is engaged.
The agent replies in the chat app the owner already uses, so there is no extra app to learn.
Keep lock changes manual at first and let the agent only report on them until you trust the setup.
Who should own it in your team
Give one person the job of looking after the agent, even if it is you.
That person keeps the token safe, decides what gets watched and checks the notification panel once a week.
Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →
When something new is added, such as a second thermostat, they add it to the watch list on purpose rather than watching everything.
That one rule keeps the agent useful instead of noisy.
A checklist to hand your installer
- Install the homeassistant plugin in the Hermes profile the business uses.
- Create a long-lived token named after the agent and store it in the password manager.
- Set HASS_URL if Home Assistant is not at the default address.
- Watch climate, door and window sensors and the alarm panel to start.
- Set a phone notify target for scheduled reports.
- Run Hermes as a background service so it survives restarts.
- Show the owner how to ask for a premises check.
Questions to ask before buying more devices
Does Home Assistant already support the device you are looking at?
If it does, the agent can use it the moment it appears in Home Assistant, with no extra setup on the Hermes side.
Will you want alerts from it, or only control?
Alerts mean adding it to the watch list; control works through the device tools straight away.
Is it a lock, alarm or anything that affects safety?
Then decide in advance whether the agent may change it or only report on it.
Other routes you may see mentioned
Search results also show forum threads about community add-ons that let Home Assistant call Hermes, rather than the other way round.
Some are early test versions, so most owners should stick to the official plugin.
Hermes can also act as an OpenAI-style API endpoint for apps that expect one, which is a job for your tech person.
What it costs you in time each week
Once it is running, the main job is reading the reports and deciding whether anything needs doing.
Plan ten minutes a week to glance at the notification panel and tidy the watch list.
Every few months, run the update command so Hermes and the plugin stay current; the upgrade keeps your settings as they are.
If you change internet provider or move Home Assistant to a new address, update HASS_URL and restart the gateway.
Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →
When to call in help
If the agent cannot see Home Assistant after a fresh token and a restart, the problem is usually the network between the two machines.
That is a quick job for whoever set up your Wi-Fi or server, and it is worth fixing properly rather than working around.
Mistakes owners make in the first week
The most common one is switching everything on at once and getting a flood of messages.
Start with three or four devices that matter, then add more once the reports feel useful.
The second is letting the agent control locks on day one; let it report first, then decide.
The third is forgetting that settings only apply after a restart, which makes a correct change look broken.
The fourth is losing the access token; if that happens, delete it in Home Assistant and make a new one.
Plain-English words you will hear
- Entity: one device or sensor in Home Assistant, such as the kitchen light.
- Domain: the type of device, such as light, climate or binary_sensor.
- Service: an action a device accepts, such as turn_on or set_temperature.
- Gateway: the part of Hermes that keeps the connection open and passes messages back and forth.
- Notify target: the name Home Assistant gives your phone or another place to send alerts.
Knowing these five words makes any conversation with your installer much quicker.
Where this fits in a bigger AI plan
A building that reports on itself is a nice first win.
The bigger wins come from agents that handle customer messages, content and follow-ups.
That is what members work through inside the AI Profit Boardroom each week.
The project itself lives on GitHub if your tech person wants to read the code.
Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →
FAQ: Hermes Agent Home Assistant for Business
Is Hermes Agent Home Assistant safe for a business?
The plugin blocks risky service domains such as shell_command and hassio, and it only acts on events you choose to watch. Keep the access token private.
Do I need a developer to set it up?
Someone comfortable with a terminal can do it in about ten minutes: one install command, one token and a short settings file.
Can it send alerts to my phone?
Yes. Set HASS_HOME_CHANNEL to your phone notify target and scheduled jobs can deliver reports there.
What devices does it work with?
Anything Home Assistant already controls, including lights, switches, climate, covers, fans, media players and sensors.
📺 Video notes + links to the tools 👉
🎥 Learn how I make these videos 👉
🆓 Get a FREE AI Course + Community + 1,000 AI Agents 👉
About Julian
I'm Julian Goldie, an SEO entrepreneur, author and founder of the AI Profit Boardroom, which has 3,400+ members.
I help business owners scale with AI agents, automation and SEO.
- I've built a 7-figure SEO and link building agency, Goldie Agency, with a team of 70+ SEO experts.
- I've grown a YouTube channel to 400,000+ subscribers.
- I wrote "Link Building Mastery".
- My Udemy courses have taught over 29,000 students.
→ Get my best AI training inside the AI Profit Boardroom
Pick one premises check, set it up this week and see how many trips it saves.
When you want AI working on the customer side too, get your Backlink Gameplan, and use this guide as your Hermes Agent Home Assistant starting point, or try Polar Rank free for 3 days.











