HA NOVA — Talk to your home.
Every change checked.
Connect your AI to Home Assistant: simple things run right away, and everything else waits for your OK.
Get started Try HA NOVA in 1 minute
No install needed to try it.
What you can do
Talk to the AI app you already use. HA NOVA does the careful part.
“Check my automations for problems”
Checks them against 40+ rules. Finds conflicts, dead triggers, and mistakes that are hard to spot.
“Why didn’t my motion light trigger last night?”
Replays what really happened. Shows where it failed and why.
“Turn on the porch light at sunset and off at 11 PM”
Builds the automation and checks it. Shows it to you before it saves anything.
“Unlock the front door”
Shows what will happen, then waits for you to confirm.
“Build a dashboard for the living room”
Builds it with the cards you have. Saves a copy first, so “undo that” brings it back.
More things to ask
“Turn off the kitchen light”
Turns it off right away, then checks that it really is off. Whole rooms and scenes show a preview first.
“What happened to my living room temperature overnight?”
Reads the history and tells you what happened, in plain words.
“What do I have, and where is this sensor used?”
Counts your rooms, devices, automations, and integrations. Lists the automations, scripts, scenes, groups, helpers, and dashboard cards that use the sensor, and says what it couldn’t check. Exact numbers, never a guess.
“What’s the average temperature upstairs?”
Works out averages and totals across rooms in one step. Names the sensors it used, and any it couldn’t read.
“My door sensor died, I paired a new one”
Moves automations, scripts, scenes, dashboards, helpers, and energy sources to the new device. You check it all as one plan.
“Turn this Node-RED flow into an automation”
Explains the flow, finds each device, and builds a normal Home Assistant automation. Turns the old rule off, but keeps it.
“Check my ESPHome config for the garage sensor”
Explains the device file in plain words. Flags removed settings, pins that can’t do the job, and passwords written into the file.
Try these on the demo house
A shared house with no real devices. A free Claude account works.
Safe by design
Here is what happens when the AI wants to change something.
-
Looks first
Reads your real devices, automations, and past runs first. No guessing.
-
Shows the exact change
You see exactly what will change before anything is saved. Simple actions, like one light, run right away instead.
-
You approve
Unlocks, gates, garage doors, the alarm, restarting Home Assistant, and deletes need more than an OK. You confirm them:
- Click Confirm in a window on your computer
- Or tap your linked phone at the same time
No window and no phone? You type a four-digit code. Some deletes always use the code.
More about confirming
Everything that isn’t a simple action waits for your OK. HA NOVA decides what needs it, never the AI.
Window. On a computer with a screen, a window opens. Click Confirm (OK on Windows) or Cancel. Your AI never sees a code.
Phone. The one phone you linked, iPhone or Android, asks at the same time as the window, in the Home Assistant Companion app. The first answer counts, and the phone shows the result. With no screen, like on a Linux server, or with the window turned off, the phone asks alone. (Not with a standalone relay that runs on your own token.) You can answer on the locked phone or its Apple Watch. So whoever holds your phone can answer too, but only for that one action, and only while it waits (up to 90 seconds on a computer, up to 3 minutes in Claude or ChatGPT). To link, move, or turn off phone confirmation, you must unlock the phone. Once a phone is linked, an action it can’t reach is refused, never moved to chat.
Code. With neither, you get a four-digit one-time code, in chat or in your AI app’s own form where it shows one. The AI can see the code, so it only counts when you type it yourself.
Automation, script, and dashboard deletes use the window or the phone. Other deletes, like helpers, scenes, and areas, always use a four-digit code in chat.
If anything changed since the preview, nothing is sent. Before a restart, HA NOVA checks your config first. If something is wrong, it says what before you confirm.
Careful: anything you let control your screen can click that window too. That means computer use, apps you gave Accessibility access, and on Windows and some Linux desktops, other programs. To turn the window off, run
ha-nova setup confirm-window off.Every safety rule, and the test behind it: the safety page on GitHub (opens in a new tab).
-
Saves a way back
Saves a copy before it deletes or fully replaces an automation, script, scene, or dashboard.
-
Saves and checks
Saves the change, then reads it back to check that it matches what you approved.
-
Checks its own work
Looks for mistakes, conflicts, and things that may break later.
-
Offers a safe test
After an automation or script is saved, you get a test plan that fits the risk.
-
Lets you undo
Reply
revertto undo the latest checked update.More about undo
Deleted automations, scripts, scenes, dashboards, and storage helpers come back from their saved copy. “Undo that” right after a delete works too.
Revert and saved copies only cover changes made through HA NOVA. For anything else, use a Home Assistant Backup. It covers the whole system.
Which changes get all eight steps
Automations and scripts get all eight steps. Their test plan can switch nothing, or name every device that will switch before you say go. Helpers get a preview and a check. Dashboards show every changed view and card, save a copy first, and can be undone. For devices, one clear everyday action, like turning off one light, runs right away and gets checked. Everything else shows a preview first.
Ground rules
-
The Relay’s Home Assistant login never reaches the AI.
-
Stored codes, like a lock code or the backup password, stay hidden from the AI. Which codes?
-
On App installs, each device gets its own connection. One click in NOVA cuts a device off.
-
Every rule the AI follows is a plain text file. Read them on GitHub (opens in a new tab).
-
No HA NOVA cloud in the middle. No usage tracking. No install counting.
Get started
One line to copy. One setup page. One sign‑in.
Three steps to connect
- Run the installer. Paste one line on your computer. A page opens and finds your Home Assistant and AI apps.
- Sign in with Home Assistant. Use the owner account: the first one made in Home Assistant. Setup installs the NOVA Relay App if needed.
- Add your phone, then look around. Click “Use this phone”, then tap “Allow” on it. Then you see your home at a glance.
On a phone or tablet? Open this page on your computer. Or, right on this phone:
macOS
Open the Terminal app, paste the line, and press Enter.
curl -fsSL https://raw.githubusercontent.com/markusleben/ha-nova/main/install.sh | bashLinux
Open a terminal, paste the line, and press Enter.
curl -fsSL https://raw.githubusercontent.com/markusleben/ha-nova/main/install.sh | bashWindows
Open PowerShell from the Start menu, paste the line, and press Enter.
irm https://raw.githubusercontent.com/markusleben/ha-nova/main/install.ps1 | iexA page opens and finds your Home Assistant.
Want to look first? Try the demo house.
Not the owner?
The page asks the owner to sign in on this computer. If the owner can’t come over, they make a six-digit code for you. See “Connect with a code” below.
Connect with a code
No browser, or using SSH on Linux? Then you connect with a six-digit code from the NOVA page instead.
Setup shows the NOVA Relay App page: click “Add”, then Install and Start. (Skip this if the App already runs.) The owner opens NOVA in the Home Assistant sidebar and clicks “Connect a device”. You type the six-digit code. It works once and expires in minutes.
Can’t sign in on this computer at all? Choose “Use a six-digit code instead”. The owner can make it on any device.
Over SSH, this only works well on Linux. On Windows and macOS, run setup on the computer itself. Over SSH, HA NOVA usually can’t save its login there.
Which Home Assistant works?
Any install type. On HA OS and Supervised, setup installs the NOVA Relay App for you.
Container and Core run the same relay as a standalone container, set up with a token. It uses one shared token, not one connection per device. Follow the standalone container guide (opens in a new tab).
Works with
- Claude Code
- Claude Desktop
- Codex CLI
- OpenCode
- Google Antigravity
- Hermes Agent preview
No AI app on your computer? Use Claude or ChatGPT.
HA NOVA is young. Back up your setup before you let AI change anything.
Use it from your phone
Ask about your home and change it in the Claude app on your phone. No computer has to stay on.
How easy is it?
- Turn on remote access. Turn on remote access for Home Assistant Link. Your Settings may still call it Home Assistant Cloud. Your own HTTPS address works too.
- Flip the switch. Turn on chat apps in setup, or on the NOVA page in the sidebar. Home Assistant restarts once.
- Add HA NOVA to your chat. Click “Add to Claude”. Or, on a computer, paste the address setup shows into ChatGPT. Then sign in to Home Assistant as the owner.
Needs Home Assistant 2026.10 or newer, on HA OS or Supervised. Only the owner can turn it on and use it.
More about chat apps
ChatGPT: use it on a computer, with a paid plan. On a phone, ChatGPT can only answer. Which plans?
Unlocks, the alarm, and deletes still wait for a tap on your phone. No phone? You type a four-digit code in the chat. The AI can see that code too, so it protects less than your phone. On the NOVA page, you can require the phone, or let chat apps only read.
Everyday actions, like a light, run right away. Then HA NOVA checks them. But at first, Claude asks before each step. To ask less, open Customize → Connectors → HA NOVA in Claude. Set the read-only tools and “Control a device” to “Always allow”. Leave “Run a confirmed change” on “Needs approval”.
Your own address needs a valid certificate. Self-signed certificates, plain http://, Tailscale, and local addresses don’t work.
Claude or ChatGPT holds a Home Assistant sign-in for your account. It works for all of Home Assistant, not only HA NOVA. Anyone who can use your Claude or ChatGPT account can reach your home through it. To sign them out, open your Home Assistant profile, then Security.
Helpers, dashboards, and files still need HA NOVA on a computer.
Turn chat apps off before you remove the NOVA Relay App.
Step by step, and what to do if it doesn’t connect: the chat apps guide on GitHub (opens in a new tab).
At home and away Beta
At home, your computer talks to Home Assistant directly. Away, it can use your paid Home Assistant Link plan (formerly Home Assistant Cloud; Nabu Casa). You turn it on in setup. Then it switches by itself.
More about away access
“Local only” stays the default. Your login stays in your computer’s own safe storage.
You need HA OS or Supervised, with remote access turned on. You also need a computer with a screen to approve it once. Container, Core, WSL, and setups without a screen, like a service or a gateway, work at home only.
How it works
The NOVA Relay App on your server talks to Home Assistant. Skills, plain text files on your computer, hold everything the AI knows.
The HA NOVA program on your computer, not the AI, decides what needs a preview or your OK.
Questions
- Is it free?
- Yes. HA NOVA is free and open source, under the MIT License (opens in a new tab). Your AI app has its own plans, and so does Home Assistant Link for away access (Beta).
- What data leaves my home?
- Nothing goes to HA NOVA: no HA NOVA cloud, no usage data, no install counts. Away from home, it goes through your own Home Assistant Link, and HA NOVA gets none of it. Your AI app sees what it reads, and its maker’s rules apply. The demo house keeps a short log: see the privacy page.
- Can the AI see my codes?
- Not the stored ones. The Relay’s login, a lock or alarm code in its settings, the backup password, and the Thread network key stay hidden. Codes written into automations are not hidden.
- Does it work with ChatGPT?
- Yes, on a computer. ChatGPT needs a paid plan that lets you add your own plugins. We tested Pro. The free plan can’t. On a phone, ChatGPT can only answer, so use the Claude app there.
- How do I remove it?
- Run
ha-nova uninstallon your computer. It asks: remove it, keep the pairing for a reinstall, or cancel. On the last computer, it can remove the NOVA Relay App too, after the owner signs in. Using chat apps? Turn them off before the App is removed.