Architecture
Modulo uses a core pipeline engine that connects agents, connectors, and model backends into governed pipelines.
Modulo is a graph engineering platform: the pipeline engine compiles a StateGraph of agent nodes, where each node is an agent, connector, or gate and each edge is a typed, governed transition. Graph engineering is the practice of designing agent systems as explicit graphs — nodes and edges — rather than a single agent loop; Modulo makes that graph executable, observable, and auditable.
Layers
| Layer | Role |
|---|---|
| Pipeline Engine | Compiles and executes a StateGraph of agent nodes |
| Connector Hub | Manages tool integrations (GitHub, 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
- A trigger (manual, webhook) starts a pipeline run
- The engine compiles a StateGraph from the pipeline definition
- Each node executes in order – agents call models via backends, tools via connectors
- HITL checkpoints pause execution until a human reviews the artifact
- The completed artifact is routed to its destination (PR, ticket, file)