syntropy-core 0.2.0

A fair source multi-agent AI framework where agents are organized on a mathematical lattice — Python runtime, SDK, and CLI.

Syntropy Python

The Python runtime, SDK, and CLI for Syntropy — a fair source multi-agent AI framework where agents are organized on a mathematical lattice and hierarchy emerges from interaction, not assignment.

pip install syntropy-core

The distribution is syntropy-core; the import stays import syntropy.

Capabilities

• Immutable lattice join and meet operations with deterministic ordering, verified against the shared axiom contract that the Elixir runtime also enforces (property-based parity tests on both sides).
• Semantic task routing (single, parallel, all, auto) with explicit-agent overrides, contribution-aware EMA position recomputation, and symmetric connection tracking.
• Retained observation events, task history, structural recommendations with approval-gated persistent join/meet, and replay snapshots.
• Provider adapters: mock (default), OpenAI-compatible, and Ollama for fully offline local runs — selected through runtime settings.
• Pluggable memory stores: in-memory (default) or stdlib-sqlite3 persistence via SYNTROPY_STORE=sqlite.
• GatewayClient: typed REST client for hosted gateways (agents, runs and cancellation, events, history, recommendations, webhook CRUD), plus syntropy.remote.EventChannel for live websocket event streaming and syntropy.webhooks HMAC signature helpers.
• A syntropy CLI: run, review (local paths and public GitHub URLs), submit --remote --watch, runs, agents deploy --preset, events --follow, and trust for structural decision review.

Quick start

# Fully local, no API key (requires Ollama)
SYNTROPY_LLM_PROVIDER=ollama syntropy run "Monolith or microservices for our next product stage?"

# Against a hosted gateway
export SYNTROPY_GATEWAY_URL=https://your-gateway.example.com
export SYNTROPY_API_TOKEN=syn_...
syntropy submit "Review our failover strategy" --remote --watch

Examples live in examples/ — start with 01_basic_lattice.py (local lattice) and 02_remote_gateway.py (hosted gateway).

License

Fair Source, Business Source License 1.1: free for development, evaluation, research, and personal use; free in production under US $1M revenue/funding; each version converts to Apache 2.0 four years after release.