sillyhome-next-dev/ARCHITECTURE.md

SillyHome Next — Architekturübersicht

Ziel ist ein lokales, datensparsames, erklärbares Smart-Home-Intelligenzsystem für Home Assistant. Es analysiert Historie, erkennt Gewohnheiten, erstellt Vorhersagen, empfiehlt Automationen und kann auf Wunsch einfach in Automationen übersetzen. Vier Intelligenzebenen sind vorgesehen: regelbasiert, ML-gestützt, LLM-unterstützt und autonomer Hausagent.

Leitentscheidungen

• Lokal-first und datensparsam; keine Cloudpflicht.
• Trennung von Datenintegration, Trainingspipeline, Vorhersageservice und Erklärungsschicht.
• Standardintegration über MQTT und Home Assistant WebSocket plus REST.
• Schnittstellen über FastAPI und OpenAI-kompatible Endpunkte.
• Langzeitdaten in PostgreSQL und TimescaleDB; Vektoren für semantische Suche optional.
• Deployment über Docker Compose; Kubernetes optional für erweiterte Betriebsgrößen.
• Tests, Docs und Changelog sind Pflichtbestandteil jeder Änderung.