idea98-algeiot-algebraic-or.../README.md

1009 B

AlgeIoT: Algebraic Orchestration for Distributed IoT Resource Markets (Edge City Edition)

This repository implements a production-oriented MVP for AlgeIoT, a CatOpt-inspired orchestration stack for city-scale IoT coordination.

Contents

  • Core primitives: LocalDevicePlan, SharedSignal, PlanDelta, DualVariables, etc.
  • Lightweight ADMM-lite coordinator (asynchronous, fault-tolerant)
  • Two starter adapters: StreetLightController and EVChargingAggregator
  • A tiny registry to map adapters to canonical contracts
  • Simulation scaffolding and a basic test suite

Architecture and design decisions are documented in AGENTS.md. This README gives a quick launch path and how to extend the MVP.

Getting Started

  • Install dependencies and build: see test.sh for a quick validation loop
  • Run tests: ./test.sh
  • Extend adapters under idea98_algeiot_algebraic_orchestration.adapters

Note: This is a production-oriented MVP. The codebase focuses on well-scoped, robust components with clear interfaces and tests.