Home Assistant — Smart Home Hub

Imagine your smart home is a busy orchestra—lights, thermostats, sensors, and speakers all playing their own tune. Hermes Agent is the conductor that listens to every note and can tell any musician to play louder or stop. That’s exactly what this integration does: it lets your AI agent watch your home in real time and control it with simple commands.

What You Get

This feature gives you two superpowers:

1. A Listening Ear (Gateway) — Hermes Agent connects to Home Assistant like a friend who’s always watching your house. It sees when a light turns on, a door opens, or the temperature drops—instantly.
2. A Helping Hand (Smart Home Tools) — Four special tools let you ask questions like “What’s the living room temperature?” or give orders like “Turn off the kitchen lights” using plain English.

Step 1: Get Your Secret Key

First, you need a special password called a “Long-Lived Access Token.” Think of it as a VIP pass that lets Hermes Agent talk to your Home Assistant.

1. Open your Home Assistant dashboard
2. Click your Profile (bottom of the sidebar)
3. Scroll down to Long-Lived Access Tokens
4. Click Create Token—name it “Hermes Agent”
5. Copy the token immediately (you won’t see it again!)

Step 2: Tell Hermes Agent the Secret

Now you need to store that token in your computer’s environment variables. This is like writing the VIP pass number in a secret notebook that only Hermes Agent reads.

Open your terminal and run:

export HOME_ASSISTANT_TOKEN="your_token_here"
export HOME_ASSISTANT_URL="http://your-home-assistant-ip:8123"

Pro tip: Put these lines in your .bashrc or .zshrc file so they’re always available. Don’t worry if that sounds technical—just paste them at the bottom of the file.

Step 3: Test It Out

Once you’ve set the variables, restart Hermes Agent. Then try asking:

"What's the temperature in the bedroom?"
"Turn on the hallway lights"
"Are any doors open right now?"

If everything works, you’ll get instant answers and actions. If not, double-check that your token has no spaces and your URL is correct.

Real-Life Example

Say you’re at work and want to make sure your home is safe. With this integration, you could ask Hermes Agent: “Check if any windows are open” or “Set the thermostat to 20 degrees before I get home.” It’s like having a helpful house-sitter who never sleeps.

Summary & Practical Tip

This integration turns Hermes Agent into your home’s brain—it listens to everything and can control anything. Start small: connect just a few lights or sensors first. Then expand as you get comfortable.

My best tip: Create a routine! Ask Hermes Agent every morning: “What’s the weather and should I close the bedroom window?” It’ll become your favorite smart home habit.