# AlgoGraph: Algebraic Portfolio Compiler for Edge-Compute

This repository implements a minimal, production-ready MVP of AlgoGraph: a portable, algebraic graph-based framework for edge-enabled portfolio optimization. It models portfolio components as a graph of local optimization blocks, data channels, and verifiable plan updates.

- Core primitives: PortfolioBlock, SignalMorphism, PlanDelta, DualVariables
- Tiny edge-friendly solver: ADMM-lite for convex objectives
- Adapters: basic scaffolding for venue connectors
- Verifiable plan deltas with versioning metadata

How to run tests
- bash test.sh

Packaging
- This package is provided as a Python project. The package name is algograph_algebraic_portfolio_compiler_f.
- See pyproject.toml for packaging metadata and dependencies.

Roadmap highlights
- Phase 0: core algebraic primitives, two device adapters, one risk model adapter
- Phase 1: offline backtester, delta-sync protocol, privacy budgets
- Phase 2: cross-venue demo with two brokers
- Phase 3: HIL/mobile pilot and performance benchmarks
- Phase 4: governance and adapter marketplace

DSL Sketch (Minimal)

- LocalProblem: id, assets, objective, constraints, signals
- SharedSignal: named data channels carrying signals between blocks
- DSLPlanDelta: versioned incremental plan changes with timestamp and author
- DSLDualVariables: simple container for Lagrange multipliers

This DSL sketch is implemented in the package at src/algograph_algebraic_portfolio_compiler_f/dsl.py and can be used to bootstrap a portable, algebraic graph representation for edge deployments.