Install

Needs Home Assistant 2026.9 or newer and an API key from typesafe.ai.

Through HACS

Not in the HACS default list yet, so add it as a custom repository once. hacs/default#11052 is queued; when it merges, steps 1 and 2 go away.

1. Open HACS, then the three dot menu, then Custom repositories
2. Paste https://github.com/AboveColin/HA-Jev, set Type to Integration, Add
3. Search HACS for Jev, then Download
4. Restart Home Assistant

By hand

Copy custom_components/jev from the latest release into your config/custom_components/ directory and restart.

HACS will not update a copy installed this way

A manual install is invisible to HACS, so you will not be told when a release lands. Prefer the custom repository route unless you have a reason not to.

Setting it up

Settings, Devices and services, Add integration, then Jev (TypeSafe).

The API key is the only thing it asks for. It is checked against the live API before the entry is created, so a wrong key fails here rather than silently later.

Use Reconfigure to replace the key later. That keeps your entities and their history.

Options

Option	Default	What it does
Daily input token budget	0	Stops evaluating for the day once spent. 0 means no limit
Price per million input tokens	0.042	Only affects the estimated cost sensor
Fall back to this agent	none	Where the conversation agent sends what it cannot route
Act only above this confidence	0.6	Below it, a spoken command goes to the fallback
Allow whole-house commands	off	Commands naming no room and no device. Turning everything off is always allowed

The budget is a tripwire, not a quota to run against. Put it past anything a working setup would use.