Syntropy Lattice Framework

Syntropy is a contract-first monorepo for a self-organizing agent operating system where hierarchy emerges from interaction, not assignment.

It combines:

• A real-time operational control plane and execution engine written in Elixir/OTP (BEAM).
• A builder-friendly Python SDK and CLI.
• A shared mathematical contract (Axioms) that keeps both runtimes strictly aligned.

Mathematical Determinism

The core of Syntropy is a mathematical lattice. Agent selection, task routing, and synthesis are guaranteed by three strict invariants:

1. Commutativity: join(a, b) == join(b, a)
2. Associativity: join(a, join(b, c)) == join(join(a, b), c)
3. Idempotency: join(a, a) == a

Whether you run a local Python script or a highly-concurrent, distributed Elixir cluster, the system behaves deterministically according to this contract.

Hosted platform (Syntropy Cloud)

The Fair Source repos ship the runtime, SDK/CLI, and operator mission control. Syntropy Cloud Pro is the managed hosted layer: a proprietary multi-tenant cockpit, BYOK, webhooks, replay retention, and team workspaces on a dedicated runtime per tenant. Self-hosting the open core remains fully supported.

License: Fair Source (BUSL 1.1)

Syntropy is Fair Source software, released under the Business Source License 1.1. The full text and parameters are in LICENSE. In short:

• Free for development, evaluation, research, and personal use — everyone can read the code, inspect the math, and build with it locally.
• Free in production for individuals and small organizations — production use is included while your organization's gross revenue and funding each stay under US $1M (aggregated across affiliates).
• Commercial license required for production use at scale — organizations above that threshold need a commercial license for production deployments. Contact license@syntropyos.dev.
• No hosted or managed Syntropy services — regardless of size, you may not offer Syntropy itself (or a service that substitutes for it) to third parties as a hosted, managed, or embedded service. Applications and products you build on top of Syntropy are yours and are not restricted by this condition.

Each released version automatically converts to Apache License 2.0 four years after its first public distribution. This delayed conversion means adopting Syntropy is never a bet on the vendor: if the project is ever abandoned, the code you depend on becomes freely reusable under Apache 2.0.

"Syntropy" and the Syntropy logo are trademarks of Syntropy OS and are not licensed under the BUSL. See CONTRIBUTING.md for the contributor license agreement.

Quick Start

Python SDK

pip install syntropy-core

The Python runtime provides a local, in-memory execution environment perfect for building tools and testing routing semantics, plus a syntropy CLI and a GatewayClient for hosted gateways.

# Local run with Ollama (no API key required)
SYNTROPY_LLM_PROVIDER=ollama syntropy run "Monolith or microservices for our next product stage?"

Working from a source checkout instead:

cd python
uv pip install -e ".[dev]"
pytest -v
python examples/01_basic_lattice.py

Elixir BEAM Engine

The Elixir runtime is the highly concurrent, supervisor-driven mission control. It provides real-time event channels, visual execution graphs, and distributed routing.

cd elixir
mix deps.get
mix setup
../scripts/syntropy-dev.sh

Open http://localhost:4100 to access the Mission Control dashboard.

Monorepo Layout

• /elixir — The Phoenix/LiveView concurrent runtime.
• /python — The local Python runtime and SDK.
• /shared — The axioms.json mathematical contract both runtimes enforce.
• /scripts — Utility scripts for testing and cluster initialization.

Source-Grounded Reviews (Librarian)

For local or private repository review, Syntropy uses Librarian as the retrieval layer. Librarian is a local-first Java CLI that indexes codebases with Lucene and emits bounded evidence packets Syntropy consumes through stable JSON contracts:

• librarian retrieve → librarian.retrieve.v1 (platform local-path reviews)
• librarian evidence → librarian.evidence.v1 (runtime agent follow-up expansion)

Install Librarian from GitHub Releases, put the binary on your PATH, or set SYNTROPY_LIBRARIAN_BIN. Public GitHub URL review works without Librarian as a lighter web fallback.