Pino
f4f23796d5
- .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
46 lines
1.3 KiB
Markdown
46 lines
1.3 KiB
Markdown
# 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
|
|
```
|