Skip to main content

Oikos

Your Home Assistant, read into your memory.

Oikos reads what your Home Assistant reports: temperatures, humidity, doors and windows, motion, who is home, the weather. It can keep watching while its window is closed, and it saves camera stills into its own vault, so you can search them months later.

Oikos only reads. Its one network call to Home Assistant is a read of /api/states and of camera stills. It cannot turn a device on or off.

The cartridge id is @mnemosyne-plugins/oikos. Its code lives at Mnemosyne-OS/Oikos.

Not yet tried on a real Home Assistant

The author's own README says Oikos has been tested against recorded answers, never against a real Home Assistant box. Version 0.1 means what it says.

Add it​

Its README installs it from its repository. In MnemoHub, choose + Add a cartridge, then a repository, and paste https://github.com/Mnemosyne-OS/Oikos. See Add an external cartridge. It spends the free slot for an outside cartridge.

Connect​

  1. In Home Assistant, open your profile and create a long-lived access token.
  2. In Oikos, type the Address on your network (192.168.1.8:8123 works, no scheme needed).
  3. Paste the Long-lived access token, on a single line.
  4. Press Connect. Mnemosyne OS asks you before Oikos reaches that device. It asks again for any other address or port.

What you see​

  • Readings: Sensors, Open, closed, moving, Who is home and Weather, grouped by kind. A device that does not answer keeps its tile and shows no number.
  • Watch in the background: Oikos keeps reading while its window is closed, as long as Mnemosyne OS runs. While you were away lists what moved, with the reading.
  • Cameras: Capture now saves one still. Keep an archive with Start capturing saves stills on a rhythm, only while the window is open. The panel says how many files a year that makes.

Where your data goes​

  • Camera stills are files in Oikos's own vault folder. Mnemosyne OS indexes them like any picture. You can open the folder and delete any of them.
  • The Home Assistant token is kept in Oikos's settings on your computer, as plain text. Revoke it from Home Assistant to cut access.
  • Each device address you approve is listed in Settings › Governance. Revoke it there to stop the background watch.