https://github.com/timmo001/home-assistant-assist-desktop

Use Home Assistant Assist on the desktop. Compatible with Windows, MacOS, and Linux
https://github.com/timmo001/home-assistant-assist-desktop

assist cross-platform desktop home-assistant home-assistant-assist stt svelte tauri tts

Last synced: about 1 month ago
JSON representation

Use Home Assistant Assist on the desktop. Compatible with Windows, MacOS, and Linux

• Host: GitHub
• URL: https://github.com/timmo001/home-assistant-assist-desktop
• Owner: timmo001
• License: apache-2.0
• Created: 2023-12-10T21:43:57.000Z (9 months ago)
• Default Branch: master
• Last Pushed: 2024-04-30T07:09:42.000Z (4 months ago)
• Last Synced: 2024-05-01T15:40:41.562Z (4 months ago)
• Topics: assist, cross-platform, desktop, home-assistant, home-assistant-assist, stt, svelte, tauri, tts
• Language: Svelte
• Homepage: https://timmo.dev
• Size: 854 KB
• Stars: 81
• Watchers: 4
• Forks: 1
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Home Assistant Assist - Desktop

This is a desktop app for [Home Assistant](https://www.home-assistant.io) Assist. It is built using [Tauri](https://tauri.app) and [Svelte](https://svelte.dev).

Compatible with Windows, MacOS, and Linux.

You can find out more about Home Assistant Assist [here](https://www.home-assistant.io/voice_control/).

[Community forum post](https://community.home-assistant.io/t/home-assistant-assist-desktop/656737?u=timmo001)

[Discuss project](https://github.com/timmo001/home-assistant-assist-desktop/discussions)

[Report issues](https://github.com/timmo001/home-assistant-assist-desktop/issues)

## Features

- Speech to text

- Text to speech

- Assist pipeline picker via Assist icon in main window

- Toggle with keyboard shortcuts

  - `Ctrl + Alt + A` to toggle main window

  - `Alt + Shift + A` to trigger voice pipeline

- System tray icon

  - Double click to toggle main window

![Screenshot 01](https://community-assets.home-assistant.io/original/4X/b/f/f/bff536dbd616670babbf52ae25940a3d8cb1e2c6.png)

![Screenshot 02](https://community-assets.home-assistant.io/original/4X/b/2/8/b2811c098b857ebc63292b8cd52a5240ea17ae37.png)

## Installation

You can download the latest release from the [releases](https://github.com/timmo001/home-assistant-assist-desktop/releases) page.

### Setup

When you first run the app, you will be prompted to enter your Home Assistant URL and Long Lived Access Token. These are used to connect to your Home Assistant instance.

> Your Home Assistant URL must be https due to [browser security restrictions](https://developer.mozilla.org/en-US/docs/Web/Security/Mixed_content).

## Development

### Prerequisites

- [Node.js](https://nodejs.org/en/)

- [Yarn](https://yarnpkg.com/)

- [Rust](https://www.rust-lang.org/)

### Setup

```bash

yarn install

```

### Running

```bash

yarn tauri dev

```

### Building

```bash

yarn tauri build

```

## Attributions

A lot of the assist code is based on the Home Assistant frontend code. Here are some of the files which were used:

https://github.com/home-assistant/frontend/blob/dev/src/dialogs/voice-command-dialog/ha-voice-command-dialog.ts

https://github.com/home-assistant/frontend/blob/dev/src/util/audio-recorder.ts

https://github.com/home-assistant/frontend/blob/dev/src/data/conversation.ts