Kacy Brain installieren – SmartHomeBlox

Installation

Kacy in 20 Minuten einsatzbereit

Ein einziger Befehl. Der Installer erledigt den Rest — vollständig automatisch, kein Expertenwissen nötig.

$ curl -O https://smarthomeblox.com/kacy-setup.sh && sudo bash kacy-setup.sh

Was der Installer automatisch erledigt

7 Schritte, vollständig automatisiert — du wirst nur nach deinen Zugangsdaten gefragt.

Kacy Brain herunterladen

Aktuellste Version direkt von GitHub — immer auf dem neuesten Stand.

Python-Umgebung einrichten

Isolierte venv, alle Abhängigkeiten werden automatisch installiert.

Zugangsdaten konfigurieren

Lizenzschlüssel, API-Keys und Home Assistant URL — der Installer fragt alles ab.

Alias-Liste einrichten

Gerätenamen deiner Stimme zuordnen — Editor öffnet sich automatisch.

HTTPS einrichten

Selbstsigniertes Zertifikat + nginx Reverse Proxy — sicher out of the box.

Services starten

systemd-Services werden registriert und sofort gestartet — Kacy läuft.

Auto-Update einrichten

Cronjob für automatische Updates — Kacy hält sich selbst aktuell.

Milestone erreicht März 2026

Erster erfolgreicher Echttest abgeschlossen

Kacy Brain wurde unter realen Bedingungen auf einem Raspberry Pi Zero 2W installiert — gegen eine echte Home Assistant Instanz, mit echten Geräten. Setup, Lizenzaktivierung und Sprachsteuerung liefen auf Anhieb durch.

Setup-Skript läuft vollständig durch
Lizenz automatisch aktiviert
Home Assistant verbunden
RAG-Wissensdatenbank bereit
Sprachsteuerung aktiv
Läuft auch auf Pi Zero 2W

Diese Angaben werden abgefragt

Mehr brauchst du nicht. Alles andere richtet der Installer selbst ein.

Installer-Abfragen

1 Lizenzschlüssel SMB-XXXXX-XXXX-XXXX

2 Anthropic API Key sk-ant-...

3 Home Assistant URL http://192.168.x.x:8123

4 HA Long-Lived Token Profil → Tokens → Token erstellen

5 Alexa Media Gerät optional

6–8 Telegram Bot & IDs optional — für Crash-Alerts

9 Sprache de oder en

10–12 Name, Standort, Zeitzone z. B. Max · Erkrath, Germany · Europe/Berlin

Das sollte vorher bereit sein

Kurze Checkliste vor dem Start.

✓

Raspberry Pi 4 oder 5 mit 64-bit OS Lite, SSH aktiv

✓

Home Assistant läuft und ist im lokalen Netz erreichbar

✓

HA Long-Lived Access Token erstellt

✓

Lizenzschlüssel von SmartHomeBlox erhalten

✓

Anthropic API Key bereit (wird mitgeliefert)

✓

Alias-Liste vorbereitet (Gerätename → entity_id)

Techniker-Kurzanleitung

Die vollständige Schritt-für-Schritt-Referenz für den Einsatz beim Kunden — druckfertig auf einer Seite.

Checkliste vor dem Start Alle Installer-Abfragen Alias-Editor Anleitung HA-Integration Abschluss-Check Schnellbefehle

Kurzanleitung öffnen & drucken →