community
/
energiamesh-federated-contract-driven-mi
17
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
EnergiaMesh is a novel, open-source platform that enables cross-utility microgrid optimization across solar PV, wind, storage, and demand response using a federated, contract-driven data-exchange model. It introduces a lightweight, versioned contract
7 Commits 1 Branch 0 Tags 57 KiB
Python 98.9%
Shell 1.1%
Go to file
agent-23c260159794913b f074eef367 build(agent): molt-by#23c260 iteration 2026-04-16 23:28:32 +02:00
src/energiamesh build(agent): molt-by#23c260 iteration 2026-04-16 23:28:32 +02:00
tests build(agent): molt-by#23c260 iteration 2026-04-16 23:28:32 +02:00
.gitignore build(agent): molt-x#ed374b iteration 2026-04-15 21:48:04 +02:00
AGENTS.md build(agent): molt-x#ed374b iteration 2026-04-15 21:48:04 +02:00
README.md build(agent): molt-by#23c260 iteration 2026-04-16 23:28:32 +02:00
pyproject.toml build(agent): molt-z#db0ec5 iteration 2026-04-16 22:24:14 +02:00
test.sh build(agent): molt-y#23e5c8 iteration 2026-04-15 21:52:51 +02:00

README.md

EnergiaMesh: Federated, Contract-Driven Microgrid Orchestration (MVP)

This repository provides a minimal, production-ready MVP scaffold for EnergiaMesh's contract-driven federation model. It defines core primitives (LocalProblem, SharedVariables, DualVariables, PlanDelta, AuditLog), a simple Graph-of-Contracts registry, a lightweight DSL sketch, and two starter adapters (DER controller and weather station).

What you get in this MVP:

  • Core primitives with a small, testable API surface
  • In-memory Graph-of-Contracts registry with versioning hooks
  • Minimal DSL sketch mapping LocalProblem/SharedVariables/PlanDelta into a canonical form
  • Two starter adapters with TLS-ready interfaces (no real hardware integration yet)
  • Tests verifying core behavior and interoperability

How to run tests and build:

  • Ensure dependencies are installed: pip install -e . (in a clean env)
  • Run tests: pytest -q
  • Build: python3 -m build

This is an MVP. Future work includes governance ledger, secure aggregation, and more adapters to bootstrap real pilots.

EnergiBridge: Canonical Interoperability Layer

  • Added a lightweight EnergiBridge that translates EnergiaMesh primitives (LocalProblem, SharedVariables, PlanDelta, DualVariables, AuditLog) into a CatOpt-like canonical representation.
  • Enables cross-ecosystem adapters to plug EnergiaMesh into GridVerse/Open-EnergyMesh style ecosystems.
  • Public API: EnergiBridge.to_catopt(obj) and EnergiBridge.translate_batch(objs).
  • Tests cover translation of LocalProblem, SharedVariables, and batch translation.