energiamesh-federated-contract-driven-mi/README.md

EnergiaMesh Skeleton

This repository provides a production-ready skeleton (MVP) for EnergiaMesh, a contract-driven federated microgrid orchestration framework with on-device forecasting capabilities. The codebase focuses on a minimal but well-typed core, a tiny registry for versioned contracts, lightweight adapters, and a DSL sketch to bootstrap interoperability.

Key components

• Core primitives: LocalProblem, SharedVariables, DualVariables, PlanDelta, AuditLog
• Graph-of-Contracts: in-memory registry for contracts and adapters
• Adapters: starter Python adapters for DER controllers and weather stations
• DSL sketch: lightweight representations of core primitives for rapid iteration

Getting started

• Install: pip install -e . (in a clean virtual environment)
• Run tests: ./test.sh
• Build: python3 -m build

This scaffold is intentionally minimal and production-ready. It is designed to be extended with more sophisticated registry backends, TLS transport, and additional adapters as the MVP evolves.