Penduline

Prediction and logistics software built on the Umwelt engine, from Cerebral Frame. It runs on your own machine, against your own Home Assistant.

What it is

Penduline keeps a belief about each room in your house and tells you what it believes, and why, in plain sentences:

Landing presence: last seen 40 minutes ago; I still believe someone is up there, and here is why.

The thinking is done by Umwelt, the engine. Penduline is the membrane between Home Assistant and that engine.

• Local-first. Your token, states and history stay in your house. Nothing hosted is required; the invite-only hosted app is optional.
• Suggestion-only. It starts in Watch: it reads and writes nothing. It never switches anything until you say so, and locks are sense-only.
• You author the meaning. Which room a sensor is in, and what silence means, is your call. Penduline drafts; you decide.

Beta

Penduline is in beta. It will get things wrong, and we want to know where. How long it takes before it says something useful: DARK (not measured yet).

Install the local-first version

Penduline runs on a machine in your house, against your own Home Assistant. Your token stays on that machine. Copy-paste install steps.

Be aware: the source is not public yet. The GitHub repository is private and shows "404" without access, and there is no PyPI package, release, Docker image or Home Assistant add-on. The steps work from a checkout, so today they are for people who already have access.

Have an invite? Sign in

Sign in to the hosted app. The hosted app is invite-only and optional. Connecting a Home Assistant to it is read-only, and Penduline stays suggestion-only.

Which address is for what

• penduline.cerebralframe.com (this site): what Penduline is, how to install the local-first version, how to ask about the beta.
• app.penduline.cerebralframe.com: the invite-only hosted app, for people who have an invite.

Ask about the beta

You run Home Assistant and can run a Python program on a machine in your house. This site has no form and collects nothing, and there is no public tracker yet because the repository is private. Beta volunteers are being recruited in small numbers; how to reach us is DARK until it is chosen. Please do not post your token, password or address anywhere.

Nothing is required of you. A screenshot of a confession, right or wrong, helps; blur names of people and your Home Assistant URL first. We will never ask for your token, your password or your address, and we never take your history automatically.

Optional data donation: never required, never automatic. If you choose to, penduline donate builds a minimised bundle on your machine and lets you preview it first; nothing leaves your house without your say-so. Where to send it privately is TBD. Terms (draft): docs/DATA_DONATION.md.

Licence and source

Penduline is free software under the GNU AGPL-3.0-or-later. Contributions need a CLA. Penduline's source is not public yet. Umwelt, the engine, is public: github.com/AQuantumArchitect/umwelt-engine.