← back to ecosystem
app experimental version 0.1.0 hex unreleased package jido_cluster elixir ~> 1.18

Jido Cluster

Distributed keyed instance management and storage for multi-node Jido runtimes

Experimental support. Open exploration with no stability guarantee.

GitHub ★2 Issues
View package metadata source →

RELATED PACKAGES

AT A GLANCE

Global singleton semantics per cluster key across connected nodes
Deterministic owner-node placement via rendezvous hashing
Cross-node lookup, call, cast, and stop operations by key
Conservative ownership rebalancing with configurable migration limits

DEEP DIVE

Overview

Jido Cluster provides a distributed runtime layer for keyed Jido agent instances across multiple BEAM nodes. It adds ownership, routing, and recovery patterns on top of Jido instance management for multi-node deployments.

Purpose

Jido Cluster is the distributed runtime package for teams running Jido agents beyond a single node.

Boundary Lines

  • Owns distributed instance ownership, node routing, and rebalancing mechanics for keyed agents.
  • Provides cluster-aware storage adapter surfaces for cross-node recovery flows.
  • Does not replace core agent contracts, action semantics, or provider-specific integration packages.

Major Components

Cluster Instance Manager

Jido.Cluster.InstanceManager coordinates keyed ownership and lifecycle operations for instances across connected nodes.

Routing and Ownership

Uses deterministic owner resolution and cross-node call/cast APIs to route operations to the correct runtime node.

Rebalancing Loop

Includes conservative periodic migration controls so ownership can adapt without aggressive movement.

Storage Integrations

Provides cluster-friendly storage adapter options for shared persistence in distributed runtime topologies.