Entangle
Entangle is a federated runtime designed for distributed AI organizations.
Core trick
Coordinates agent runners over signed Nostr events so they need no inbound ports, and passes work products as git references.
Description
Entangle is a federated runtime designed for distributed AI organizations. Unlike standard agent orchestrators that rely on a central controller, Entangle treats an organization as a governable graph where agents and users exist as signed nodes across different machines.
The project introduces a "federated dev profile" that allows for:
- Decentralized Coordination: Using Nostr as a signed event fabric, enabling runners to communicate without public IP inbound access.
- Git-Backed Artifacts: Work products (code, reports, source changes) are committed and exchanged via real git references, ensuring durability and lineage.
- Human-in-the-loop: Users participate as first-class nodes with stable identities, signing tasks and approvals directly.
- Live Operations: A "Studio" control room that provides a live projection of the graph state, sessions, and audit trails.
README excerpt
# Entangle Entangle is a self-hosted federated runtime for observable coding-agent organizations. It models an AI organization as a live graph: human users, coding agents, and service participants are nodes; edges define who may talk, delegate, review, and approve; runners execute assigned nodes wherever they live; signed Nostr events coordinate work; git-backed references carry durable artifacts; Studio and CLI read the same Host projection. Entangle is not a chatbot wrapper and not a local-only agent demo. A compact same-machine deployment is available for development, but it uses the same federated model as a multi-machine deployment. ## What Exists Today The repository contains a real TypeScript monorepo with: - `entangle-host`: Host Authority, graph state, runner trust, assignment, projection, audit, package, resource, runtime, session, artifact, memory, and User Node APIs. - `entangle-runner`: generic runner join flow, signed observations, `agent_runner` and `human_interface` runtime paths, OpenCode and external engine adapters, git artifact handoff, source-change handling, and structured node memory. - `entangle-studio`: browser operator console over Host state. - `entangle user-client`: browser participant client served by running User Nodes. - `entangle` CLI: headless operator and User Node workflows over the same Host boundary. - deterministic smoke paths for federation, User Node messaging, fake OpenCode, fake OpenAI-compatible providers, exte