open-fdd 3.0.31

Arrow-native HVAC fault detection runtime — lint, test, and run apply_faults_arrow rules on columnar telemetry (PyPI). Use GHCR Docker images for the full edge operator stack.

Open-FDD

Open-source supervisory fault detection for buildings — Arrow-native rules, optional PyPI embeddable runtime, and a full Docker/GHCR edge operator stack (BACnet, bridge API, dashboard, MCP).

---

Install / run

Full Open-FDD edge stack (Docker / GHCR)

Use GHCR for BACnet polling, Operator Bridge API, React dashboard, historian, and MCP sidecar.

Image	Role
ghcr.io/bbartling/openfdd-bridge	API, dashboard, historian
ghcr.io/bbartling/openfdd-commission	BACnet discover, read, poll
ghcr.io/bbartling/openfdd-mcp-rag	MCP + doc-search

Prefer pinned release tags in production (not floating latest):

export OPENFDD_IMAGE_TAG=3.0.30   # match your release
docker pull ghcr.io/bbartling/openfdd-bridge:${OPENFDD_IMAGE_TAG}
docker pull ghcr.io/bbartling/openfdd-commission:${OPENFDD_IMAGE_TAG}
docker pull ghcr.io/bbartling/openfdd-mcp-rag:${OPENFDD_IMAGE_TAG}

Edge bootstrap: Run with Docker images.

Python package (PyPI)

Use PyPI when you only need the embeddable Arrow-native FDD runtime — lint, test, and run rules in your own pipelines (cloud, IoT, notebooks) without Docker.

pip install open-fdd

import pyarrow as pa
from open_fdd.arrow_runtime import run_arrow_rule

code = '''
import pyarrow.compute as pc
def apply_faults_arrow(table, cfg, context=None):
    return pc.greater(table["SAT"], float(cfg["high"]))
'''
result = run_arrow_rule(code, pa.table({"SAT": [70.0, 90.0]}), {"high": 85})
print(result.true_count)

Need	Use
Run FDD in your Python / cloud pipeline	PyPI open-fdd
BACnet + UI + bridge on an edge host	GHCR Docker images
Portfolio / MCP agent over Tailscale	Docker stack + portfolio docs

Examples: examples/. Release: developer/release-process.

---

Develop

git clone https://github.com/bbartling/open-fdd.git && cd open-fdd
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test,dev,analytics]"
pytest open_fdd/tests -q

Contributor layout: AGENTS.md and developer docs.

---

License

MIT — see LICENSE.