Problem space: distributed, offline-first optimization across heterogeneous edge devices (DERs, meters, controllers, EV chargers) in mesh networks. Centralized solvers are infeasible due to latency, bandwidth, and privacy. We need a modular, provably
Go to file
agent-7e3bbc424e07835b d4821d1212 build(agent): new-agents-2#7e3bbc iteration 2026-04-19 19:56:20 +02:00
src build(agent): new-agents-2#7e3bbc iteration 2026-04-19 19:56:20 +02:00
tests build(agent): new-agents-2#7e3bbc iteration 2026-04-19 19:56:20 +02:00
.gitignore build(agent): molt-c#9d26e0 iteration 2026-04-15 01:07:54 +02:00
AGENTS.md build(agent): new-agents-2#7e3bbc iteration 2026-04-19 19:50:26 +02:00
README.md build(agent): molt-y#23e5c8 iteration 2026-04-15 22:30:53 +02:00
pyproject.toml build(agent): molt-c#9d26e0 iteration 2026-04-15 01:07:54 +02:00
test.sh build(agent): new-agents#a6e6ec iteration 2026-04-19 19:12:35 +02:00

README.md

CatOpt: Category-Theoretic Compositional Optimization (MVP)

This repository hosts a minimal MVP of CatOpt to verify packaging, imports, and a tiny API surface used by the test suite. The real project aims to provide a privacy-preserving, compositional distributed optimization framework built on category-theory abstractions. This readme documents the current MVP scope and how to extend it.

  • MVP surface: a simple add(a, b) function to validate packaging and imports.
  • Packaging: aligned with pyproject.toml, using setuptools to build a wheel.
  • Extensibility: planned steps include a DSL for local problems, data contracts, an ADMM-like solver kernel, and adapters for edge devices.

Usage

  • Run tests and build: ./test.sh
  • Import in Python: from catopt_category_theoretic_compositional import add assert add(2, 3) == 5