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

APPENDIX

Quickstart

1. Python-Venv anlegen und Abhängigkeiten installieren:

python -m venv .venv
source .venv/bin/activate
pip install -e .

2. Konfiguration aus .env.example übernehmen und anpassen:

cp .env.example .env

3. API starten:

uvicorn app.main:app --reload

4. Erreichbar unter:

• http://127.0.0.1:8000/health - Health-Check
• http://127.0.0.1:8000/docs/ - OpenAPI-Dokumentation
• http://127.0.0.1:8000/v1/entities - Home-Assistant-Entities

ENV-Konfiguration (.env.example)

• SILLYHOME_HA_URL – Basis-URL deiner Home-Assistant-Instanz (z. B. http://homeassistant.local:8123)
• SILLYHOME_HA_TOKEN – Long-Lived Access Token aus Home Assistant (nur lesen)

Hinweis: Nutze ausschließlich Long-Lived Access Tokens mit Leserechten. Niemals Administrator-Tokens oder Passwörter eintragen. .env gehört nicht in Versionskontrollsysteme.

Tests

pytest -q
ruff check .
mypy app tests