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.