Architecture
Five layers. One system.
MUSU is a layered runtime where each component has a single responsibility. Agents flow through Prime, execute in Engine, distribute via Mesh, and every action is gated by Control.
System Flow
PrimeOrchestrator
EngineExecutor
MeshDistributor
ControlGatekeeper
MemoryPersistence
Control gates every action. Memory persists every state change.
Prime
The brain of the swarm.
- Capability-based routing via Gateway Protocol
- OODA loop: Observe → Orient → Decide → Act
- Multi-agent dispatch and lifecycle management
- Task decomposition and work distribution
Rustmusu-prime crateGateway Protocol
Engine
Local inference. Zero latency.
- BitNet 1.58-bit quantized inference
- Worker pool management with job lifecycle
- Resource-aware scheduling
- Runs on CPU — no GPU required
Rustmusu-engine crateBitNet b1.58
Mesh
Peer-to-peer. No relay.
- Direct P2P connections — no central relay
- QUIC transport with TLS 1.3 encryption
- NAT traversal for cross-network connectivity
- mDNS auto-discovery on local networks
Rustmusu-node-bridge crateQUICTLS 1.3
Control
Every action is judged.
- GO / FIX / BLOCK verdict system
- Intent zones with configurable policies
- Full audit trail for every decision
- Real-time intervention capabilities
Rustmusu-interceptor crateSignal Protocol
Memory
Conflict-free. Immutable.
- CRDT-based distributed state (GSet, OrSet, LwwRegister, PnCounter)
- Immutable run blocks with full history
- Conflict-free replication across nodes
- ChromaDB integration for semantic search
Rustmusu-common crateCRDTChromaDB
Technology Stack
Core RuntimeRust
Agent InterfaceMCP (TypeScript)
NetworkingQUIC + TLS 1.3
SecurityGO/FIX/BLOCK Gates
StorageCRDT + ChromaDB
Explore the source code or read the docs.