OpenEnergySphere EnergiBridge (EnergiBridge MVP)

This repository implements a production-ready skeleton for OpenEnergySphere's federated, contract-driven cross-domain energy planning platform. The MVP focuses on the EnergiBridge interoperability layer, mapping OpenEnergySphere primitives to a canonical IR and enabling plug-and-play adapters across DERs, meters, pumps, and buildings while preserving offline-first operation and governance.

Note: Added a minimal EnergiBridge mapper (EnergiBridgeMapper) to illustrate canonical mappings between LocalProblem objects and a vendor-agnostic IR. This enables straightforward extension to more complex cross-domain workflows and adapters.

Architecture highlights

• Core primitives: LocalProblem, SharedVariables, DualVariables, PlanDelta, PrivacyBudget, AuditLog
• Graph-of-Contracts registry for adapters and data schemas with per-message metadata
• Adapters: starter implementations (substation_meter, der_aggregator)
• EnergiBridge: mapping functions between OpenEnergySphere primitives and a CatOpt-like IR
• Server: FastAPI app exposing endpoints to register contracts and adapters
• Storage: in-memory by default, with potential for SQLite/PostgreSQL persistence

Getting started

• Install dependencies and run tests via test.sh
• Run API locally: uvicorn energysphere.server.main:app --reload

This README intentionally provides a compact architectural overview and a concrete MVP workflow to accelerate collaboration and iteration.