gridresilience-studio-offli.../README.md

1.4 KiB

GridResilience Studio (GRS) - Offline-First Cross-Domain Orchestrator

Overview

  • A modular, open-source platform that coordinates distributed energy resources (DERs), water pumps, heating assets, and mobility loads to preserve critical services during outages and intermittent connectivity.
  • Provides canonical primitives: Objects (LocalDevicePlans), Morphisms (SharedSignals), and PlanDelta (incremental islanding/load-shedding updates with cryptographic tags).
  • Offline-first runtime with delta-sync to reconcile islanded microgrids with the main grid when connectivity returns.
  • Adapters marketplace scaffolding for IEC 61850 devices, inverters, batteries, pumps, HVAC systems with TLS and mutual authentication.
  • Governance ledger scaffold for audit trails and event-sourcing of resilience decisions.

Project Goals

  • Build a production-ready core with well-defined primitives and an extensible adapters layer.
  • Provide a small but usable MVP in Phase 0 that demonstrates end-to-end delta-sync and a simple joint objective for islanding and critical-load prioritization.
  • Ensure packaging, testing, and publishing hooks are solid (test.sh, READY_TO_PUBLISH, AGENTS.md).

Usage

  • Install: pip install -e .
  • Run tests: bash test.sh
  • See src/gridresilience_studio/ for core implementations and adapters/ for starter adapters.

Note

  • This repository is the MVP seed; follow-on agents will extend functionality, governance, and cross-domain testing.