catopt-graph-graph-calculus.../README.md

908 B

CatOpt-Graph MVP

This repository hosts a minimal, testable MVP of CatOpt-Graph: a graph-calculus-inspired orchestration layer for compositional optimization across edge devices.

  • Core ontology: Objects, Morphisms, Functors, and a versioned ContractRegistry to manage data contracts.
  • Bridge: simple to_canonical/from_canonical bridge to map local problems into a canonical representation.
  • ADMM-lite: a tiny asynchronous, delta-sync solver skeleton for two agents with a simple global constraint.
  • Adapters: scaffolded rover and habitat adapters ready for extension.
  • Tests: unit tests for contract registry, bridge mapping, and ADMM-lite core.

How to run

  • Prerequisites: Python 3.10+, pip, and a POSIX shell.
  • Run tests: bash test.sh
  • Build package: python3 -m build

This MVP is intentionally small and opinionated to enable rapid iteration and interoperability testing with other ecosystems.