CommonsGrid: Community-Managed, Privacy-Preserving Energy Commons

Overview

A neighborhood-scale energy commons platform enabling residents to co-create and govern an energy marketplace using local PV, storage, EVs, and flexible loads.
Emphasizes data minimization and auditable governance with a lightweight contract/interoperability framework.

Key features (high level)

Community Governance Ledger: versioned policy blocks, crypto-signed approvals, and an auditable decision log.
Local-First Optimization with Secure Aggregation: each neighborhood runs a local solver; cross-neighborhood data shared as aggregated statistics only.
Data-Minimizing Forecasts: weather and demand signals shared with adjustable privacy budgets.
Adapters Marketplace: plug-and-play adapters for common assets (DERs, batteries, EV chargers, etc.).
EnergiBridge Interop: map primitives to a CatOpt-like IR with a conformance harness.
Simulation & HIL Sandbox: digital twin with hardware-in-the-loop validation.

What you will find here

A Python package with core primitives, toy adapters, a simple governance ledger, and a small solver scaffold.
Lightweight tests validating governance and adapter mappings.
A minimal README linking to packaging metadata and test commands.

Usage

Run tests: ./test.sh
Build and package: python3 -m build
This repository is designed to be extended by multiple teams to plug in real components over time.

Licensing

All code is provided as a starting point for research and pilot deployments; please review LICENSE when available.

See also: AGENTS.md for contributor guidelines.