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

20 lines
1009 B
Markdown

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