Files
sillyhome-next/ARCHITECTURE.md
Otto b3cf68eade
Some checks failed
quality / test (3.11) (push) Has been cancelled
quality / test (3.13) (push) Has been cancelled
quality / test (3.11) (pull_request) Has been cancelled
quality / test (3.13) (pull_request) Has been cancelled
CONTROL-001: add safe HA automation handoff
2026-06-14 16:21:57 +02:00

1.3 KiB

SillyHome Next — Architekturübersicht

Ziel ist ein lokales, datensparsames und erklärbares Smart-Home-Intelligenzsystem für Home Assistant. Nutzer wählen ausschließlich erlaubte Aktoren. Das System ordnet Kontext automatisch zu, erkennt historische Nutzerhandlungen, trainiert pro Aktor ein Verhaltensmodell und trifft zunächst nur Shadow-Vorhersagen. Autonomes Schalten wird separat pro Aktor freigegeben.

Leitentscheidungen

  • Lokal-first und datensparsam; keine Cloudpflicht.
  • Trennung von Datenintegration, Kontextzuordnung, Verhaltenslernen, Vorhersage und Aktorausführung.
  • Logbook-basierte Herkunftserkennung; eindeutig erkannte HA-Automationen zählen wie manuelle Bedienungen. Eigene SillyHome-Schaltungen werden nicht zurückgelernt.
  • Ausführung nur für freigegebene, reversible Domains und Zustände sowie mit Konfidenzschwelle und zustandsbezogenem Cooldown.
  • Eindeutig passende HA-Automationen können bei einer SillyHome-Übernahme pausiert und beim Rückfall in den Shadow-Modus wieder fortgesetzt werden.
  • Standardintegration über die lokale Home-Assistant-REST-API.
  • Persistenz als atomische lokale Modell- und Aktorartefakte.
  • Deployment als Home-Assistant-Add-on oder über Docker Compose.
  • Tests, Docs und Changelog sind Pflichtbestandteil jeder Änderung.