Supported languages

The intents repository lists 66 languages. How far each one is differs a lot: some cover nearly every intent, others have just started. The progress overview shows the score of each language, per intent.

languages.yaml in the intents repository is the source. For every language, it has:

• nativeName: the name of the language, in that language.
• isRTL: true for languages written right to left.
• leaders: the GitHub usernames of the language leaders.
• support: per region, which speech-to-text and text-to-speech engines work for the language, like Whisper, Speech-to-Phrase, Piper, or Home Assistant Link.

The table below is a snapshot of that file. When they differ, languages.yaml is right.

Marathi (mr) is listed, but has no sentences yet. sr-Latn is generated from sr: change Serbian in sr, and the Latin script version follows.

Is your language missing? You can add it. This is a bigger first step than improving an existing language, so plan for a few rounds of review.

Set up the repository as described in Contribute sentences and responses, then run:

python3 -m script.intentfest add_language <code> <native name>

• <code> is the language code. Use the two letter ISO 639-1 code where there is one, like pl. Regional or script variants add a suffix, like pt-BR or sr-Latn.
• <native name> is the name of the language in the language itself, like Polski.
• Add --rtl for a language written right to left.

The script adds your language to languages.yaml, and creates its sentence, response, and test files from the English ones. The sentences are left empty, and the responses start with TODO so you can see what still needs translating.

Cannot run the script yourself? Ask in the #language-leaders channel on the Home Assistant Discord server, and a maintainer can run it for you.

Limit your first pull request to:

• The error responses in sentences/<code>/_common.yaml.
• The slot combinations of HassTurnOn and HassTurnOff that intents.yaml marks as required, with their tests.
• The lists in lists/<code>/ and the rules in rules/<code>/ that those sentences need.

That is enough for people to start turning things on and off in your language. More intents follow in later pull requests, one at a time.

A new language starts without a leader. If you keep contributing, consider becoming the language leader.