# 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`

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

**Table of Contents:**

- [Home Assistant](#home-assistant)
- [Lyrion Music Server (LMS)](#lyrion-music-server-lms)
- [Mosquitto](#mosquitto)
- [Wyoming](#wyoming)
- [Zigbee2mqtt](#zigbee2mqtt)

## Home Assistant

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

## Lyrion Music Server (LMS)

For instructions on setting up the Lyrion Music Server on kubernetes, 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).

Deployments and scripts on services/wyoming repo folder.

[Continuous deploy](./.gitea/workflows/casa-services-deploy.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.

Deployments and scripts on services/Zigbee2mqtt repo folder.

[Continuous deploy](./.gitea/workflows/casa-services-deploy.yaml).