Draft copy, pending Luke's approval.

Penduline runs on your machine

Penduline is a home model for Home Assistant. It runs on your own machine, reads your own Home Assistant, and tells you what it believes about your rooms and why. It is free, and the code is AGPL-3.0-or-later.

What it does

• It reads your Home Assistant, read-only. Your token, your states and your history stay in your house.
• It never switches anything. Locks are sense-only. Whatever it suggests, you decide.
• It says what it believes and why. For example: last seen on the landing 40 minutes ago, still believed occupied, and the reason. Where it has not measured, it says so rather than guess.
• It counts every entity. Each one is placed on a room, ignored with a reason, or marked as still to decide. Nothing is silently dropped.

What it does not do

• It does not send anything to us. Nothing from the local runtime is ever sent.
• It does not need your camera feeds, and it ignores cameras and faces.
• It does not need an account.

How it works

1. Install Penduline on a machine in your house.
2. Export your entity list and run the census, which shows what each entity is and what is left to decide.
3. Write an overlay: which room each sensor is in, and what silence means there.
4. Watch: Penduline follows your house and changes nothing.
5. See what it believes, and why, in your own Home Assistant.

The install steps are in the README.md of the Penduline repository, for now.

Price

The software is free. Help with building your overlay is coming as a map session, where a person builds it with you: DARK / coming. Its price is DARK / TBD.

If you want to help, you can send a contribution. Nothing here is required to use Penduline.

Penduline is an independent project and is not affiliated with or endorsed by Home Assistant, Nabu Casa or the Open Home Foundation.