29 lines
1.6 KiB
Markdown
29 lines
1.6 KiB
Markdown
# 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.
|