# casa

Welcome to my casa  repository, where Home Assistant and other services are hosted.  
This repository is dedicated to documenting and maintaining the server configuration and workflows.

The primary goal is to establish an k3s cluster capable of isolating services and communications related to home automation at the network level.  
The server operates within its own VLAN (`casa`) but requires controlled communication with other VLANs, such as `IOT Vlan`

**Table of Contents:**

- [Home Assistant](#home-assistant)
- [Lyrion Music Server (LMS)](#lyrion-music-server-lms)
- [Mosquitto](#mosquitto)
- [Wyoming](#wyoming)
- [Zigbee2mqtt](#zigbee2mqtt)
- [Hosting Setup](#hosting-setup)
- [Development, Maintenance and Deployment](#development-maintenance-and-deployment)

## Home Assistant

[Git Repo](/:root/marcio.fernandes/homeAssistant)

## Lyrion Music Server (LMS)

For instructions on setting up the Lyrion Music Server Docker container, refer to the [LMS Git Repository](/:root/marcio.fernandes/lms).

For information on integrating Lyrion Music Server with Home Assistant, visit the [Home Assistant Git Repository](/:root/marcio.fernandes/homeassistant#squeezebox-lyrion-music-server).

## Mosquitto

[Git Repo](/:root/marcio.fernandes/mosquitto)

## Wyoming

A peer-to-peer protocol for voice assistants (basically JSONL + PCM audio)

```json
{ "type": "...", "data": { ... }, "data_length": ..., "payload_length": ... }
<data_length bytes (optional)>
<payload_length bytes (optional)>
```

Used in Rhasspy and Home Assistant for communication with voice services.

This is an open standard of the Open Home Foundation.

For more information about home assistant integration [check home assistant repo](/:root/marcio.fernandes/homeassistant#wyoming).

Because of performance wyoming whisper is currently hosted on chimera kubernetes cluster [deployment](./services/wyoming/whisper.kubernetes-deployment.yaml)

Links:

- [https://github.com/home-assistant/addons/blob/master/whisper/DOCS.md](https://github.com/home-assistant/addons/blob/master/whisper/DOCS.md)
- [https://github.com/rhasspy/wyoming-faster-whisper](https://github.com/rhasspy/wyoming-faster-whisper)
- [https://exitcode0.net/posts/wyoming-whisper-docker-compose/](https://exitcode0.net/posts/wyoming-whisper-docker-compose/)
- [https://exitcode0.net/posts/wyoming-piper-docker-compose/](https://exitcode0.net/posts/wyoming-piper-docker-compose/)

## Zigbee2mqtt

Zigbee to MQTT bridge, get rid of your proprietary Zigbee bridges

Attached SONOFF Universal Zigbee 3.0 USB Dongle Plus to the Proxmox node and configure USB passthrough so the VM can use it.

## Hosting Setup

For more information about k3s cluster hosting setup check [readme](./docs/k3s-cluster.md).

## Development, Maintenance and Deployment

Using visual studio code an dev container.