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