JLo 54a1dd2d5a
Add VPE to voice product docs (#37513)
* Draft

* simplest way to get started

* Re working local

* Small line break

* typo

* removing "Questions" section that makes not a lot of sense.

* tiny rephrase

* markdown

* use heading instead of bold

* Update source/voice_control/voice_remote_local_assistant.markdown

* Update source/voice_control/index.markdown

Co-authored-by: Paulus Schoutsen <balloob@gmail.com>

* Remove one sentence

* Update source/voice_control/voice_remote_local_assistant.markdown

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* Update source/voice_control/index.markdown

Co-authored-by: Paulus Schoutsen <balloob@gmail.com>

* Remove wizard picture

* Update source/voice_control/voice_remote_local_assistant.markdown

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Co-authored-by: Paulus Schoutsen <balloob@gmail.com>
2025-02-21 07:21:15 +01:00

15 KiB

title, related
title related
Talking with Home Assistant - get your system up & running
docs title
/voice_control/android/ Assist on Android
docs title
/voice_control/apple/ Assist on Apple
docs title
/voice_control/thirteen-usd-voice-remote/ Build a $13 voice remote using an ESPHome device
docs title
/voice_control/best_practices/ Best practices with Assist
url title
https://www.nabucasa.com/config/assist/ Home Assistant Cloud
url title
https://voice-pe.home-assistant.io/ Voice Preview Edition

This section will help you set up Assist, which is Home Assistant voice assistant.

Assist allows you to control Home Assistant using natural language. It is built on top of an open voice foundation and powered by knowledge provided by our community.

The simplest way to try out Assist is inside our companion app. Look for the Assist icon Assist icon at the top right of your dashboard.

The simplest way to get started with Assist is with our recommended voice assistant hardware, the Home Assistant Voice Preview Edition.

As for the rest of Home Assistant core functionalities, Assist can be personalized and extended to fit your needs.

  • It can work locally or leverage the greatest LLMs of the moment.
  • It can work on your phone or tablet or other custom voice devices.

Getting Started

When you configure voice assistant hardware made for Home Assistant, it will use a wizard to help you configure your system and get started to use voice.

Our recommended voice assistant hardware is the Home Assistant Voice Preview Edition.

In case your hardware does not support our wizard, do not worry. Here are two detailed guides based on how you plan to process your voice (Locally, or using Home Assistant Cloud voice services)

Expand and Experiment

Once your setup is up and running and you follow the best practices, check all the possibilities we found for Expanding your Assist setup, and further experiment with different setups like wake words. Do you want to talk to Super Mario? Or another figure? If you want Assist to respond in a fun way, you can create an assistant with an AI personality.

Another things you can do to further push your setup:

  • Voice assistant devices allow you to add Assist to a room and respond to wake words. Follow our tutorial to create your own for just $13.

  • You can use ESPHome to create your own awesome voice assistant, like @piitaya did with his 3D printed R5 droid:

  • If you are interested in a voice assistant that is not always listening, consider using Assist on an analog phone. It will only listen when you pick up the horn, and the responses are for your ears only. Follow our tutorial to create your own analog phone voice assistant.

Supported languages and sentences

Assist aims to support more languages than other voice assistants, but this is still a work in progress, and we need your help.

Check supported languages here
Choose your language English Spanish Portuguese German Italian Russian Japanese Turkish Korean French Catalan Polish Dutch Indonesian Chinese (Cantonese) Chinese (Mandarin) Malay Swedish Ukrainian Thai Vietnamese Finnish Norwegian Galician Arabic Urdu Greek Romanian Danish Tamil Croatian Macedonian Slovak Hebrew Serbian Hungarian Bulgarian Czech Bosnian Slovenian Azerbaijani Estonian Latvian Afrikaans Welsh Persian Lithuanian Javanese Swahili Swahili Icelandic Maltese Pashto Marathi Bengali Luxembourgish Hindi Gujarati Khmer Nepali Lao Telugu Kannada Malayalam Kazakh Somali Uzbek Georgian Burmese Mongolian Armenian Amharic Norwegian Bokmål Basque Filipino Irish Sinhala Albanian Sundanese Shanghainese Cantonese Zulu
Local
Not supported
Needs more work
Usable
Fully supported
Home Assistant Cloud
Not supported
Needs more work
Usable
Fully supported

Assist already supports a wide range of languages. Use the built-in sentences to control entities and areas, or create your own sentences.

Did Assist not understand your sentence? Contribute them.

Assist was introduced in Home Assistant 2023.2.