hcawn-ha

A 5.7M-parameter model that turns spoken Home Assistant commands into service calls. 6.0 MB (int8) or 4.1 MB (int4), runs on a CPU, no cloud, no account.

It ships with the pieces around the model: a resolver that maps what you said to your devices, a pipeline with a confidence gate and safety rules, and a simulated house you can talk to in the browser.

pip install hcawn-ha
hcawn-ha download int8        # weights from huggingface.co/datatab/hcawn-ha (SHA-256 verified)
hcawn-ha demo                 # opens the simulated house in your browser

The engine ships compiled for Linux x86-64. On other systems pip install gives you the resolver and pipeline only (pass your own generate function), and the model runs on the Hugging Face Space.

Use it in Python

from hcawn_ha import HAPipeline

registry = [
    {"entity_id": "light.kitchen_ceiling", "name": "Kitchen Ceiling Light", "area": "Kitchen", "aliases": [], "device_class": None},
    {"entity_id": "lock.front_door", "name": "Front Door", "area": "Hallway", "aliases": [], "device_class": "door"},
]
pipe = HAPipeline("int8", registry, gate=0.7)          # "int8", "int4" or a path to a .bin file

r = pipe.handle("turn off the kitchen light and lock the front door")
r["execute"]   # [{"domain": "light", "service": "turn_off", "data": {"entity_id": ["light.kitchen_ceiling"]}}]
r["confirm"]   # [{"domain": "lock", "service": "lock", ...}]   locks and garage doors wait for a "yes"
r["ask"]       # a question for the user when something was unclear, otherwise ""

execute is safe to run now, confirm needs a spoken or typed yes first, ask is shown to the user. Nothing runs when the model is unsure (confidence below gate), when the verb contradicts the tool, or when the device is ambiguous.

How it works

"turn off the kitchen light and lock the front door"
   → split into commands
   → model, per command, with confidence      {"name":"HassTurnOff","arguments":{"name":"kitchen light"}}
   → direction guard + validation
   → resolver (your registry: names, rooms, aliases)
   → Home Assistant service calls

The model never sees your device list. It copies the device phrase from the request and the resolver finds the entity, so your home can change without retraining. 13 tools: turn on / off / toggle, light brightness and colour, thermostat, humidifier, shopping list, vacuum, media pause / resume / next / previous.

Results

The acon96 numbers are the independent ones; part of the official-test result was tuned after looking at failures. Details on the model card.

Command line

License

Code: Apache-2.0. Weights: see the model card. See NOTICE for the data the model was trained on.