SillyHome Next

Modern, lokal-first und datenschutzfreundliches Smart-Home-Intelligenzsystem für Home Assistant.

Motivation

TheSillyHome zeigte die Idee: statt statischer Regeln das Zuhause aus Verhaltensmustern verstehen. Diese Architektur modernisiert den Ansatz in Richtung Explainable AI, hybride Intelligenzebenen und langlebige Wartbarkeit.

Ziele

• Home Assistant und Sensoren/Aktoren verstehen
• Historie auswerten und Gewohnheiten erkennen
• Vorhersagen erstellen und erklären
• Automationen vorschlagen und direkt generieren
• Lokal-first ohne Cloudpflicht
• Erweiterbar, testbar, dokumentiert

Quickstart (lokaler Betrieb)

1. Voraussetzungen

   • Python 3.11+
   • Home Assistant mit REST-API erreichbar
   • pip install -e .[dev]

2. Umgebungsvariablen (.env im Projektroot)

   SILLYHOME_HA_URL=http://localhost:8123
   SILLYHOME_HA_TOKEN=dein_long_lived_access_token
   

   Tipp: .env.example kopieren und anpassen. Tokens niemals committen!

3. Server starten

   uvicorn app.main:app --reload
   

4. Prüfen

   • OpenAPI-Docs: http://localhost:8000/docs
   • Health: http://localhost:8000/health
   • Entities: http://localhost:8000/v1/entities (benötigt gültige HA-Konfiguration)

5. Tests

   pytest -q
   ruff check .
   mypy app tests