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.

Turn off the kitchen light It’s off. I checked.
Simple things run right away. Then HA NOVA checks them.

“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.

Try HA NOVA in 1 minute

Safe by design

Here is what happens when the AI wants to change something.

  1. Looks first

    Reads your real devices, automations, and past runs first. No guessing.

  2. Shows the exact change

    You see exactly what will change before anything is saved. Simple actions, like one light, run right away instead.

  3. 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).

  4. Saves a way back

    Saves a copy before it deletes or fully replaces an automation, script, scene, or dashboard.

  5. Saves and checks

    Saves the change, then reads it back to check that it matches what you approved.

  6. Checks its own work

    Looks for mistakes, conflicts, and things that may break later.

  7. Offers a safe test

    After an automation or script is saved, you get a test plan that fits the risk.

  8. Lets you undo

    Reply revert to 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

Get started

One line to copy. One setup page. One sign‑in.

Three steps to connect

  1. Run the installer. Paste one line on your computer. A page opens and finds your Home Assistant and AI apps.
  2. Sign in Sign in with Home Assistant. Use the owner account: the first one made in Home Assistant. Setup installs the NOVA Relay App if needed.
  3. Allow Add your phone, then look around. Click “Use this phone”, then tap “Allow” on it. Then you see your home at a glance.

Runs on your computer

macOS

Open the Terminal app, paste the line, and press Enter.

curl -fsSL https://raw.githubusercontent.com/markusleben/ha-nova/main/install.sh | bash
Read the install script (opens in a new tab)

Linux

Open a terminal, paste the line, and press Enter.

curl -fsSL https://raw.githubusercontent.com/markusleben/ha-nova/main/install.sh | bash
Read the install script (opens in a new tab)

Windows

Open PowerShell from the Start menu, paste the line, and press Enter.

irm https://raw.githubusercontent.com/markusleben/ha-nova/main/install.ps1 | iex
Read the install script (opens in a new tab)

A 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

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?

  1. 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.
  2. Flip the switch. Turn on chat apps in setup, or on the NOVA page in the sidebar. Home Assistant restarts once.
  3. Add to Claude 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.

At home: direct Away: Home Assistant Link Your computer Home Assistant
Direct at home first. Home Assistant Link is the automatic fallback (Beta).
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.

Your computer AI app + skills NOVA Relay App on your server Home Assistant
The relay stays dumb; the skills stay smart.

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 uninstall on 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.