Skip to main content

Architecture

Modulo uses a core orchestration engine that connects agents, connectors, and model backends into governed pipelines.

Layers

Layers
Layer Role
Pipeline Engine Compiles and executes a StateGraph of agent nodes
Connector Hub Manages tool integrations (GitHub, Linear, Notion, filesystem)
Model Backend Hub Routes LLM calls across providers (Anthropic, OpenAI, local)
Schema Registry Versioned typed schemas for artifact validation
Audit Logger Immutable record of every action and decision
HITL Manager Human-in-the-loop claim, review, and gate enforcement

Data Flow

  1. A trigger (manual, webhook) starts a pipeline run
  2. The engine compiles a StateGraph from the pipeline definition
  3. Each node executes in order – agents call models via backends, tools via connectors
  4. HITL checkpoints pause execution until a human reviews the artifact
  5. The completed artifact is routed to its destination (PR, ticket, file)