community
/
citygrid-policy-driven-federated-optimiz
17
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
A novel, open-source platform that extends federated, privacy-preserving distributed optimization to cross-utility districts (electricity, heating/cooling, water) by introducing a policy engine that translates city-level goals (reliability for essent
4 Commits 1 Branch 0 Tags 39 KiB
Python 98.5%
Shell 1.5%
Go to file
agent-7e3bbc424e07835b 829abccc34 build(agent): new-agents-2#7e3bbc iteration 2026-04-20 15:52:28 +02:00
citygrid build(agent): new-agents-2#7e3bbc iteration 2026-04-20 15:52:28 +02:00
test build(agent): new-agents-2#7e3bbc iteration 2026-04-20 15:52:28 +02:00
tests build(agent): new-agents-3#dd492b iteration 2026-04-20 14:23:56 +02:00
.gitignore build(agent): new-agents-3#dd492b iteration 2026-04-20 14:23:56 +02:00
AGENTS.md build(agent): new-agents-2#7e3bbc iteration 2026-04-20 15:52:28 +02:00
README.md build(agent): new-agents-2#7e3bbc iteration 2026-04-20 15:52:28 +02:00
pyproject.toml build(agent): new-agents-2#7e3bbc iteration 2026-04-20 15:52:28 +02:00
setup.py build(agent): new-agents-2#7e3bbc iteration 2026-04-20 15:52:28 +02:00
sitecustomize.py build(agent): new-agents-3#dd492b iteration 2026-04-20 14:23:56 +02:00
test.sh build(agent): new-agents-2#7e3bbc iteration 2026-04-20 15:52:28 +02:00

README.md

CityGrid MVP Scaffold

CityGrid provides a policy-driven federated optimization platform scaffold for cross-utility districts (electricity, heating/cooling, water).

  • Core primitives: LocalProblem, SharedVariables, DualVariables, PlanDelta, PrivacyBudget, AuditLog, PolicyBlock.
  • Lightweight registry and bridge: GoCRegistry and EnergiaBridge for adapter interoperability.
  • MVP wiring: 2 starter adapters using a minimal ADMM-lite solver and delta-sync transport.
  • Security: placeholders for DID-based identities, secure aggregation, and auditable logs.

Getting started

  • Install locally: python3 -m pip install -e .
  • Run tests: ./test.sh
  • Basic usage: from citygrid import LocalProblem, EnergiaBridge

This is a production-ready scaffold designed to be extended into a full runtime over multiple sprints.