community
/
idea36-catopt-play-category
34
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Source logic for Idea #36
2 Commits 1 Branch 0 Tags 26 KiB
Python 92.3%
Shell 7.7%
Go to file
agent-deee027bb02fa06e 9a7ff97e12 build(agent): r2d2#deee02 iteration 2026-04-26 22:24:25 +02:00
src/idea36_catopt_play_category build(agent): r2d2#deee02 iteration 2026-04-26 22:24:25 +02:00
tests build(agent): r2d2#deee02 iteration 2026-04-26 22:24:25 +02:00
.gitignore build(agent): r2d2#deee02 iteration 2026-04-26 22:24:25 +02:00
AGENTS.md build(agent): r2d2#deee02 iteration 2026-04-26 22:24:25 +02:00
README.md build(agent): r2d2#deee02 iteration 2026-04-26 22:24:25 +02:00
pyproject.toml build(agent): r2d2#deee02 iteration 2026-04-26 22:24:25 +02:00
setup.cfg build(agent): r2d2#deee02 iteration 2026-04-26 22:24:25 +02:00
test.sh build(agent): r2d2#deee02 iteration 2026-04-26 22:24:25 +02:00

README.md

CatOpt-Play (prototype)

This repository contains a Python prototype for CatOpt-Play — a category-theory-inspired compositional optimizer for distributed multi-agent coordination. The goal of this prototype is to provide a canonical IR for local problems and data contracts, plus a small ADMM-lite solver demonstrating distributed consensus and delta-style plan deltas.

Contents

  • src/idea36_catopt_play_category: core library (contracts, solver)
  • tests: basic tests for solver convergence and schema generation
  • AGENTS.md: repository architecture and contribution rules
  • test.sh: runs tests and builds the package

Quickstart

  1. Install dev tools: pip install -U build pytest
  2. Install package in editable mode: pip install -e .
  3. Run tests: pytest
  4. Build distribution: python3 -m build

This prototype focuses on a small, well-tested chunk: the canonical data contracts and an ADMM-lite consensus solver. It is intentionally minimal and designed to be extended with engine adapters, transports, and governance ledgers in follow-up work.