# 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
```