AboveColin/HA-Jev

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.

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

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

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.

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.

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

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.

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.

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.

See the release history.