Blog: OpenVoiceOS and Home Assistant: A Voice Automation Dream Team

originally posted at: OpenVoiceOS and Home Assistant: A Voice Automation Dream Team | OpenVoiceOS Blog

____

OpenVoiceOS and Home Assistant: A Voice Automation Dream Team

In the world of open-source smart homes, some things just click. When you let Home Assistant handle the automation and let OVOS (Open Voice OS) handle the voice, you get a powerful partnership where each project shines. It’s a perfect synergy: one is the undisputed champion of home automation, and the other is a flexible, private powerhouse for voice interaction.

Home Assistant excels at orchestrating your devices and routines, while OVOS provides unparalleled flexibility and privacy in voice interactions. Together, they create a system that’s not only robust but also truly yours.

Let’s explore how you can bring these two together to create a truly magical smart home experience.

-----

## Give Home Assistant an OVOS-Powered Voice

The most direct way to get started is to enhance Home Assistant’s built-in voice capabilities with the specialized tools from the OVOS ecosystem. Our main goal is to make OVOS’s powerful tools accessible to as many people as possible.

To achieve this, we’ve developed dedicated Wyoming integrations that act as bridges, allowing **any** OVOS Text-to-Speech (TTS), Speech-to-Text (STT), or Wakeword plugin to be exposed to Home Assistant.

This means you’re not limited to a few options; you gain immediate access to the **entire rich ecosystem** of OVOS voice plugins, bringing a vast array of languages, voices, and recognition models directly into your Home Assistant setup.

* [Wyoming OVOS STT](GitHub - TigreGotico/wyoming-ovos-stt): Convert spoken commands into text for Home Assistant to understand.
* [Wyoming OVOS TTS](GitHub - TigreGotico/wyoming-ovos-tts): Enable Home Assistant to speak responses using OVOS’s diverse voice options.
* [Wyoming OVOS Wakeword](GitHub - TigreGotico/wyoming-ovos-wakeword): Integrate custom wakewords, allowing your Home Assistant setup to respond only when it hears your chosen trigger phrase.

The [OVOS Wyoming Docker](GitHub - TigreGotico/ovos-wyoming-docker) project makes getting these services up and running a breeze.

**Plugin Highlights: Multi-language TTS powered by ILENIA**

For us, accessibility is key. That includes language accessibility. We’re proud that this integration allows us to bring high-quality, publicly funded voices from projects like [**ILENIA**](https://proyectoilenia.es/) to a wider audience. Now, Home Assistant users can easily access fantastic, natural-sounding voices for languages like Catalan and Galician.

* **Matxa TTS for Catalan:** The [`ovos-tts-plugin-matxa-multispeaker-cat`](GitHub - OpenVoiceOS/ovos-tts-plugin-matxa-multispeaker-cat) provides multi-speaker text-to-speech capabilities for the Catalan language.
* **NosTTS for Galician:** The [`ovos-tts-plugin-nos`](GitHub - OpenVoiceOS/ovos-tts-plugin-nos: Galician TTS) offers robust text-to-speech in Galician.

It’s a great example of how open collaboration benefits everyone.

### **Setting up Wyoming Services in Home Assistant:**

When configuring Wyoming services in Home Assistant, you’ll typically refer to the [official Home Assistant documentation](Wyoming Protocol - Home Assistant). This process usually involves simply entering the IP address of your Docker container (or the host running your OVOS Wyoming services) into the Home Assistant web interface.

-----

## Let OVOS Be the Brains of the Conversation

Want to take it a step further? You can set up OVOS as a full-fledged conversational agent for Home Assistant using the **Ollama integration**.

In this setup, Home Assistant passes the user’s text to the [ovos-persona-server](Personas - OVOS Technical Manual). OVOS then figures out what you want and tells Home Assistant what to answer. It’s like hiring a brilliant conversationalist to augment your smart home interactions.

Here’s the cool part: because [ovos-persona-server](GitHub - OpenVoiceOS/ovos-persona-server) uses Ollama-compatible endpoints, you can connect it to any app that supports the Ollama or OpenAI APIs. The possibilities are huge!

-----

## OVOS with the Voice Pe

Everyone is talking about [Home Assistant Voice Preview Edition](Home Assistant Voice Preview Edition - Home Assistant), a dedicated hardware device for voice control. If you own one, you can now easily integrate it with everything discussed so far.

-----

## Welcome Your OVOS Devices into Home Assistant with HiveMind

If you have dedicated OVOS devices, the [HiveMind HomeAssistant](GitHub - JarbasHiveMind/hivemind-homeassistant) project is where the real magic happens. This integration makes your OVOS devices show up as native entities in Home Assistant, giving you a beautiful, unified control panel.

**Setting up HiveMind Integration:**

To integrate your OVOS devices via HiveMind, you’ll typically add the HiveMind integration in Home Assistant. This involves providing connection details such as a `name` for the integration, an `access_key`, `password`, `site_id`, `host` (IP address or hostname of your HiveMind server), and the `port` (defaulting to 5678). You may also have options to `allow_self_signed` certificates or enable `legacy_audio` depending on your setup.

### **Exposed Controls for OVOS Devices:**

Once integrated, HiveMind exposes a comprehensive set of controls for your OVOS devices directly within Home Assistant. This allows you to manage various aspects of your OVOS device from the Home Assistant UI, including:

* Changing the `Listening Mode` (e.g., wakeword, always listening)
* `Microphone Mute` toggle
* `OCP Player` status and controls
* Actions like `Reboot Device`, `Restart OVOS`, and `Shutdown Device`
* Toggling `Sleep Mode` and `SSH Service`
* Manually `Start Listening` or `Stop` listening
* Controlling volume level

### **Notifications Integration:**

HiveMind also enables your OVOS devices to function as notification targets within Home Assistant. This means you can configure Home Assistant automations to send spoken notifications directly to your OVOS devices, allowing them to “speak” alerts, reminders, or any other information you configure. This is exposed as a “Speak” notifier entity in Home Assistant.

### **Media Player and Music Assistant Integration:**

A fantastic feature of HiveMind integration is that your OVOS devices will show up as standard media players within Home Assistant. This allows you to control media playback on your OVOS devices directly from Home Assistant’s media player interface. Furthermore, this integration extends to services like Music Assistant, enabling you to stream music and other audio content from Music Assistant through your OVOS devices, making them a seamless part of your whole-home audio system.

-----

## Give OVOS the Keys to the Kingdom

Finally, with the fantastic [Skill HomeAssistant](GitHub - OscillateLabsLLC/skill-homeassistant: Control your Home Assistant smart home devices through OVOS or Neon.AI voice assistants.) from community member mikejgray, you can give OVOS direct control over Home Assistant.

Install this skill, and your OVOS device can now command your smart home. Just say, “Hey Mycroft, turn on the living room lights,” and watch the magic happen. It’s the classic voice assistant experience, but fully private, customizable, and powered by two best-in-class open-source projects.


The Perfect Match

When you let OVOS do the talking and Home Assistant do the automating, you get the best of both worlds. It’s a flexible, powerful, and fun combination that lets you build a smart home that is truly your own.

**A Note on This Early Preview Release**:

We’re incredibly excited to share this integration with you! Please keep in mind that this is an early preview release and is still under active development. While it’s functional and powerful, it hasn’t undergone extensive testing and may have rough edges. We’re actively working to refine it, and your feedback is invaluable!

If you encounter any pain points or have ideas for improvements, please consider opening an issue or, even better, a Pull Request on our GitHub repositories. Your contributions help us make this even better for everyone. Thanks for being an early adopter and helping us shape the future of open-source voice!


Help Us Build Voice for Everyone

OpenVoiceOS is more than software, it’s a mission. If you believe voice assistants should be open, inclusive, and user-controlled, here’s how you can help:

  • **:money_with_wings: Donate**: Help us fund development, infrastructure, and legal protection.
  • **:megaphone: Contribute Open Data**: Share voice samples and transcriptions under open licenses.
  • **:globe_showing_europe_africa: Translate**: Help make OVOS accessible in every language.

We’re not building this for profit. We’re building it for people. With your support, we can keep voice tech transparent, private, and community-owned.

:backhand_index_pointing_right: [Support the project here]( Contribute )

2 Likes