Kacy Brain – Kurzanleitung

Raspberry Pi geflasht (64-bit OS Lite), SSH aktiv

Lizenzschlüssel bereit (SMB-XXXXX-XXXX-XXXX)

Benutzerkonto mit sudo angelegt, per SSH eingeloggt

Anthropic API Key bereit (sk-ant-...)

Home Assistant läuft und ist erreichbar

Alias-Liste vorbereitet (Sprachname → entity_id)

HA Long-Lived Token erstellt (Profil → Tokens)

Kunde registriert: smarthomeblox.com/register.html

Installation starten

Abfragen des Installers

Schritt	Was passiert
1/7	setup.sh gestartet
2/7	Kacy Brain von GitHub geladen
3/7	Python-Umgebung (venv) eingerichtet
4/7	Alias-Liste → Editor öffnet sich
5/7	HTTPS-Zertifikat + nginx
6/7	systemd-Services registriert & gestartet
6,5/7	RAG-Wissensdatenbank initialisiert
7/7	Cronjob Auto-Update (tägl. 3:00 Uhr)

Entity-IDs exakt aus HA kopieren:
Entwicklerwerkzeuge → Zustände

{
  "wohnzimmerlicht": "switch.wohnzimmerlicht",
  "rollo wohnzimmer": "cover.rolladen_wohnzimmer",
  "heizung": "climate.thermostat_wohnzimmer"
}

Speichern: Strg+O → Enter | Beenden: Strg+X

Setup-Ausgabe notieren

Base URL (HTTP):  http://192.168.x.x:8000/v1
Base URL (HTTPS): https://192.168.x.x:8443/v1
API Key:          abc123def456...
Model:            kacy

Einstellungen → Integrationen → Extended OpenAI Conversation

Dann: HA Assist → Kacy als Konversationsagent setzen

Abschluss-Check

sudo systemctl status kacy-server kacy-brain
curl http://localhost:8000/health

Erwartete Ausgabe:
{ "status": "ok", "ha_connected": true, "licensed": true }

journalctl -u kacy-server -n 20 --no-pager | grep ALIAS

Erwartete Ausgabe:
ALIAS-CHECK: Alle XX Aliases gültig.

`sudo systemctl restart kacy-server kacy-brain`	Services neu starten	`nano ~/kacy/config.json`	Konfiguration bearbeiten
`journalctl -u kacy-server -f`	Live-Log	`nano ~/kacy/aliases.json`	Aliases bearbeiten
`curl -k https://localhost:8443/health`	HTTPS-Check	`bash ~/kacy/kacy_alert.sh kacy-server`	Telegram-Alert testen