44 lines
1.1 KiB
Markdown
44 lines
1.1 KiB
Markdown
# SillyHome Future
|
|
|
|
SillyHome Future is the v2 side project for a local-first Smart Home controller.
|
|
It is intentionally separate from `sillyhome-next` so v1 can stay stable while
|
|
v2 experiments with a cleaner production architecture.
|
|
|
|
## v2 Shape
|
|
|
|
- Event Core first: Home Assistant events drive decisions, APIs mostly read state.
|
|
- Split stores: runtime, learning and control data are persisted separately.
|
|
- Decision Engine v2: safety gates, causal trigger support and audit-first output.
|
|
- Handoff Matrix: explicit states for HA automation takeover and rollback.
|
|
- Rooms and scenes: groups are first-class planning objects.
|
|
- No LLM in the control path.
|
|
|
|
## Run
|
|
|
|
```bash
|
|
python -m venv .venv
|
|
source .venv/bin/activate
|
|
pip install -e ".[dev]"
|
|
uvicorn app.main:app --reload
|
|
```
|
|
|
|
## Home Assistant Add-on
|
|
|
|
Add this repository in Home Assistant:
|
|
|
|
```text
|
|
http://192.168.6.31:3000/Otto/sillyhome-future
|
|
```
|
|
|
|
Then install **SillyHome Future**. The add-on is intentionally independent from
|
|
`sillyhome-next` and starts its own v2 event-core API on port `8099` behind
|
|
Ingress.
|
|
|
|
## Test
|
|
|
|
```bash
|
|
pytest
|
|
ruff check .
|
|
mypy app tests
|
|
```
|