Skip to content
AboveColinPublic

About

Ask your house a question, get a number back. Home Assistant integration for TypeSafe Jev: typed answers as sensors, four actions for automations, and a conversation agent for Assist.

Topics

Resources

Contributing

Stars

71 stars

Watchers

2 watching

Forks

Repository files navigation

Tests hassfest HACS Action hacs_badge Home Assistant GitHub release License

Jev for Home Assistant

Ask TypeSafe Jev questions about your house and get numbers back. Jev is a decision model, not a chat model. It answers a typed question with a probability, a choice or a score, and this integration turns each answer into an entity you can automate on.

Full documentation

Not affiliated with TypeSafe. The API client is jevclient.

Every question becomes an entity, with the day's spend beside it

What it does

  • Questions become sensors: a probability, one of your options with its distribution, or a number on a scale. Add them in the UI, in YAML, or both.
  • Four actions, jev.noul, jev.choice, jev.score and jev.ask, answer inside an automation and return a response variable.
  • An AI Task entity answers ai_task.generate_data when it is called. A boolean, select or number field becomes the matching question.
  • A conversation agent for Assist routes spoken commands through the same model.
  • A house check opens a Repairs card for entities unavailable for a week, low batteries and, in one request, states that look like a mistake. A light left on can be turned off from its card and put back.
  • It reports what it spends: calls, input tokens and estimated cost per day, against a daily token budget.
  • 25 blueprints to import with one click. Seven start from your own question, and 18 handle one situation each, such as a forgotten washing machine or a window open while the heating runs.
  • Fifteen worked examples, four of them pairing Jev with an LLM.
automation:
  - alias: Remind about the washing
    triggers:
      - trigger: state
        entity_id: binary_sensor.jev_laundry_forgotten
        to: "on"
        for: "00:10:00"
    actions:
      - action: notify.mobile_app
        data:
          message: The washing is done and still in the machine.

Installation

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

HACS

Jev is not in the HACS default list, so add it as a custom repository once.

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

Open your Home Assistant instance and open a repository inside HACS.

Manual

Copy custom_components/jev from the latest release into your config/custom_components/ directory and restart. HACS does not update a copy installed this way.

Setup

Settings, Devices and services, Add integration, then Jev (TypeSafe). Enter your API key. The address field already holds the TypeSafe API.

Open your Home Assistant instance and start setting up a new integration.

To use an OpenRouter key, set the address to https://openrouter.ai/api and the model to ~typesafe/jev-latest. The install page has every option, and how to point the integration at a proxy.

Then ask your first question.

Documentation

Page What it covers
The three answers noul, choice and score, and what confidence means
Blueprints automations to import, and how to share yours
Writing a question that works how to tell it to read the numbers, and asking one thing at a time
What it costs what questions and calls cost, and the daily budget
Measurements what was measured against the live API
Troubleshooting symptoms and their causes
Limitations what it cannot do, and what it is not for

Contributing

Issues and pull requests are welcome. CONTRIBUTING.md has the full check a change must pass, and AGENTS.md the rules for coding agents.

The easiest contribution is a blueprint. If an automation at your home asks Jev something, put it in blueprints/automation/jev/ with a test case, and the blueprint page credits you. Not writing it yourself? Open a blueprint idea.

Use Python 3.14. The pinned pytest-homeassistant-custom-component requires it, and 3.13 fails at install with "No matching distribution found".

pip install -r requirements-test.txt
pytest

The tests run the integration inside a real Home Assistant with the API client replaced, so the suite spends nothing.

Supporting the project

Jev for Home Assistant is free and stays free. If it is useful to you, you can support its development through GitHub Sponsors. Sponsorship is voluntary and unlocks nothing: every feature, fix and security update ships in the public release.

Changelog

See the release history.

About

Ask your house a question, get a number back. Home Assistant integration for TypeSafe Jev: typed answers as sensors, four actions for automations, and a conversation agent for Assist.

Topics

Resources

Contributing

Stars

71 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages