Files

Pino f4f23796d5 DOC-005: Quickstart ENV-Doku hinzufügen

- .env.example mit SILLYHOME_HA_URL und SILLYHOME_HA_TOKEN
- README: Quickstart-Sektion mit Installation, Start, ENV, Prüfung, Tests
- Hinweis zu Secrets und .gitignore

2026-06-11 03:48:33 +02:00

1.3 KiB

Raw Permalink Blame History

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)

Voraussetzungen
- Python 3.11+
- Home Assistant mit REST-API erreichbar
- pip install -e .[dev]
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!
Server starten
```
uvicorn app.main:app --reload
```
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)
Tests
```
pytest -q
ruff check .
mypy app tests
```

1.3 KiB Raw Permalink Blame History

SillyHome Next

Motivation

Ziele

Quickstart (lokaler Betrieb)

1.3 KiB

Raw Permalink Blame History