EIGSEP software

A starting point for anyone setting up the EIGSEP stack on a new machine — what hardware to acquire, what to clone, how to flash and configure a Pi, where to find the wire contracts.

The contract documentation and operator runbooks are authored in the eigsep-field umbrella repo; the pages under this tab link out to that canonical source rather than copy it, so they do not drift. Outbound links currently track main — bumped to the new release tag as part of the release checklist.

Sections

  • Getting started — first-day quickstart for a new operator.
  • Hardware — the bill of materials.
  • Interfaces — Redis keys, sensor schemas, bus roles, producer contracts.
  • Operations — runbooks for deploying a new Pi and configuring the operator laptop.
  • Services — systemd units on the Pi image.

Source of truth

The canonical authority for everything below is the eigsep-field repository:

  • manifest.toml — the blessed version tuple of every package and service.
  • docs/interface/ — wire contracts, generated from sibling Python modules and CI-drift-checked.
  • docs/operator/ — operator runbooks.

When in doubt, read the source repo at the pinned tag.