Registry / workflow / home-assistant-intents

home-assistant-intents

JSON →
library2026.6.1pypypi✓ verified 82d ago

Home Assistant Intents is a community-maintained repository and Python package that provides structured intents (language-specific phrases mapped to actions) for the Home Assistant voice assistant. The package is versioned with a calendar-based scheme (2026.3.24) and releases are tied to the intents repository updates, typically weekly or on-demand. It requires Python >=3.9.

pip install home-assistant-intents
INSTALL
IMPORT
SIG · HOME-ASSISTANT-INT
H
home-assistant-intents
workflowpythonv2026.6.1
Install
1.7s avg
Import
Disk
28MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v2026.6.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 29.7MB
glibc
py 3.103.95 runs
installs and imports cleanly · install 1.7s · import 0.000s · 30MB
28MB installed
● package 28MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

get_intents
from home_assistant_intents import get_intents
from home_assistant_intents import load_intents
get_languages
from home_assistant_intents import get_languages
get_language_scores
from home_assistant_intents import get_language_scores

Load intents for English and retrieve details for a sentence. The intents structure is a dict mapping sentences to action data.

from home_assistant_intents import load_intents, get_sentence_details # Load intents for a language (e.g., English) intents = load_intents('en') # Get details of a specific sentence sentence = 'turn on the kitchen light' details = get_sentence_details(sentence, intents) print(details)
Debug
Known issues
gotchaThe package is installed as 'home-assistant-intents' (with hyphens) but imported as 'home_assistant_intents' (with underscores). Using 'import home-assistant-intents' will fail with a SyntaxError.
fix
Import using underscores: from home_assistant_intents import ...
affects: all
breakingThe load_intents function returns a dictionary keyed by domain (e.g., 'light', 'lock') rather than the flat list of sentences seen in earlier versions. Code relying on a different shape may break.
fix
Access intents via the domain key: intents['light'] instead of iterating over intents directly.
affects: >=2025.0.0
deprecatedThe function 'get_sentence_details' is deprecated as of version 2026.2.0. Use 'intent_for_sentence' instead.
fix
Replace get_sentence_details(sentence, intents) with intent_for_sentence(sentence, intents).
affects: >=2026.2.0
Upgrade
Version history
2026.6.1latest on PyPI · released Jun 2, 2026
Audit
Dependencies

No dependency data recorded yet.

Agent activity
28 hits · last 30 days
node
26
OpenAI (training)
1
Resources
home-assistant-intents — pip install home-assistant-intents · libregistry