Open-FDD

Open-FDD is a free, open-source building-to-cloud pipeline for HVAC analytics and fault detection. The same stack runs on-premises or in the cloud: high-performance Apache Arrow storage and Apache DataFusion SQL, a Rust central service, React operator UI, Mosquitto MQTTS ingest, and fieldbus edge agents for BACnet, Modbus, and Haystack — plus REST APIs and CSV/zip import when you are not on live OT.

Deploy locally or as a cloud hub and pull building data over MQTTS, APIs, or files. Today’s product is SQL-based FDD and RCx on that Arrow/DataFusion engine; the roadmap is ML and clustering on the same foundation.

---

Install / run GHCR images

Image	Role
ghcr.io/bbartling/openfdd-central	MQTTS ingest, Feather historian, DataFusion FDD, REST /api
ghcr.io/bbartling/openfdd-web	React operator SPA (browser → central /api only)
ghcr.io/bbartling/openfdd-fieldbus	BACnet / Modbus / Haystack / JSON edge
ghcr.io/bbartling/openfdd-mqtt	Mosquitto MQTTS broker
ghcr.io/bbartling/openfdd-mcp	Optional slim MCP stdio sidecar → central API

Run

git clone https://github.com/bbartling/open-fdd.git && cd open-fdd
export OPENFDD_IMAGE_TAG=nightly
export OPENFDD_JWT_SECRET='change-me'
export OPENFDD_ADMIN_PASSWORD='change-me'

./scripts/openfdd_stack_up.sh react       # local CSV lab (ready today)
./scripts/openfdd_stack_up.sh csv         # central + web only
# Cloud hub path: openfdd-fieldbus → MQTTS (see docs/operations/RAILWAY_DEPLOYMENT.md)

Update a running stack (pull, backup, rollback if health fails):

./scripts/openfdd_maint_update_resume.sh react nightly

AI Agent assistance : AGENTS.md.

PyPI package

pip install open-fdd

This is a library of rule-based FDD equations built with Pandas that serves as a reference implementation for the Open-FDD platform, which uses Apache DataFusion and SQL for production rules. It also includes tooling for AI agents to assist with engineering calculations, EnergyPlus modeling, Open-FDD stress testing, and more. Future capabilities include report writing and daily HVAC-fault email alerts—yet to be tested with Grok, OpenClaw, or the AI agent tooling of your choice.

💛 Support This Work

Support for Open-FDD directly funds the monthly time and labor required to keep the project moving forward, along with professional application-security testing to keep it strong, robust, free, and secure. Your support is greatly appreciated.

License

MIT — see LICENSE.

Version 3.3.38 on tip · PyPI 4.4.2