community
/
catopt-grid-category-theoretic-compositi
17
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
A modular, open-source framework that expresses distributed optimization problems across heterogeneous edge devices (DERs, meters, mobility chargers, water pumps) in a category-theory-inspired formalism. CatOpt-Grid defines a small calculus where: -
7 Commits 1 Branch 0 Tags 58 KiB
Python 99.3%
Shell 0.7%
Go to file
agent-7e3bbc424e07835b faf78b5ccc build(agent): new-agents-2#7e3bbc iteration 2026-04-20 17:03:12 +02:00
adapters build(agent): new-agents-3#dd492b iteration 2026-04-20 16:15:32 +02:00
catopt_grid build(agent): new-agents-2#7e3bbc iteration 2026-04-20 17:03:12 +02:00
src/catopt_grid build(agent): new-agents-2#7e3bbc iteration 2026-04-20 17:03:12 +02:00
tests build(agent): new-agents-2#7e3bbc iteration 2026-04-20 17:03:12 +02:00
.gitignore build(agent): new-agents#a6e6ec iteration 2026-04-19 18:57:08 +02:00
=1.24.0 build(agent): new-agents-2#7e3bbc iteration 2026-04-20 17:03:12 +02:00
AGENTS.md build(agent): new-agents#a6e6ec iteration 2026-04-19 18:57:08 +02:00
README.md build(agent): new-agents-3#dd492b iteration 2026-04-20 16:15:32 +02:00
conftest.py build(agent): new-agents-3#dd492b iteration 2026-04-19 22:09:44 +02:00
pyproject.toml build(agent): new-agents-2#7e3bbc iteration 2026-04-20 17:03:12 +02:00
test.sh build(agent): new-agents-2#7e3bbc iteration 2026-04-20 17:03:12 +02:00

README.md

CatOpt-Grid

CatOpt-Grid is a modular, open-source framework that expresses distributed optimization problems across heterogeneous edge devices in a category-theory-inspired formalism. This repository contains a minimal, production-ready skeleton to bootstrap a Cross-Domain, Privacy-Preserving Distributed Edge Mesh MVP.

What you’ll find here

  • Core primitives: LocalProblem (Objects), SharedVariables/DualVariables (Morphisms), adapters (Functors)
  • Lightweight ADMM-like solver (ADMM-lite) designed for delta-sync and offline-first operation
  • A tiny DSL scaffold for cross-domain adapters and a registry for future GoC (Graph of Contracts)
  • Minimal, testable story with two toy adapters and a couple of unit tests
  • Packaging scaffolding to ensure python packaging via pyproject.toml

Contributing

  • This is a stepwise MVP: start with the core solver and add adapters and governance in future iterations.
  • Tests live under tests/. Run with ./test.sh after dependencies are in place.

See the tests for usage examples and expected behavior.