# 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.

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.