# soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform architecture

> Architecture diagram of the GitHub repository soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform
- Repository: https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform

## Overview

Relay lets users design workflows in a browser, submit them for validation and compilation, and execute them on durable workers that persist progress and resume after failures. The workflow supports agents, tools, retrieval, conditions, loops, and human approvals; execution also enforces budgets, records provenance, and reports run status. The graph combines documented product stages with sampled source and SOURCE INDEX references. Some internals and integrations are unsampled, so their specific call paths are not asserted.

Main entry points: [`backend/app/worker.py`](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/worker.py) (Durable worker), [`backend/app/main.py`](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/main.py) (FastAPI), [`backend/app/agent_runtime.py`](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/agent_runtime.py) (Agent runtime), [`backend/app/compiler.py`](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/compiler.py) (Graph compiler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_studio["Workflow studio"]
  node_editor["Workflow editor"]
  node_requestui["Request routing UI<br/>[request-routing.ts]"]
  node_approvalui["Approval review"]
  node_runview["Run status UI<br/>[run-status.ts]"]
end

subgraph group_control["API and compilation"]
  node_api["FastAPI<br/>[main.py]"]
  node_workflow["Workflow model<br/>[models.py]"]
  node_validator["Graph validation"]
  node_compiler["Graph compiler<br/>[compiler.py]"]
end

subgraph group_execution["Durable execution"]
  node_worker["Durable worker<br/>[worker.py]"]
  node_policy["Execution policy"]
  node_agent["Agent runtime<br/>[agent_runtime.py]"]
  node_accounting["Token accounting"]
end

subgraph group_capabilities["Workflow capabilities"]
  node_registry["Node registry<br/>[registry.py]"]
  node_approvals["Write approvals<br/>[approvals.py]"]
  node_tools["Tool adapters<br/>[tool_service.py]"]
  node_sandbox["Python sandbox<br/>[sandbox.py]"]
  node_knowledge["Knowledge services<br/>[kb_gateway.py]"]
  node_providers["Model providers<br/>[providers.py]"]
end

subgraph group_platform["Persistence and operations"]
  node_storage[("Relational store<br/>[storage.py]")]
  node_observability["Run observability<br/>[observability.py]"]
end

node_user(("Workflow author"))
node_external{{"External systems"}}

node_user -->|"designs"| node_editor
node_editor -->|"submits workflow"| node_api
node_api -->|"parses"| node_workflow
node_api -->|"validates"| node_validator
node_api -->|"compiles"| node_compiler
node_compiler -->|"consumes model"| node_workflow
node_compiler -->|"uses node contracts"| node_registry
node_api -->|"stores runs"| node_storage
node_api -->|"starts worker"| node_worker
node_worker -->|"claims and checkpoints"| node_storage
node_worker -->|"executes graph"| node_compiler
node_worker -->|"applies policy"| node_policy
node_worker -->|"tracks spend"| node_accounting
node_worker -->|"runs agents"| node_agent
node_agent -->|"calls models"| node_providers
node_agent -->|"invokes tools"| node_tools
node_agent -->|"retrieves documents"| node_knowledge
node_agent -->|"runs Python"| node_sandbox
node_worker -->|"pauses for review"| node_approvals
node_approvals -->|"persists decisions"| node_storage
node_user -->|"reviews action"| node_approvalui
node_approvalui -->|"submits decision"| node_api
node_tools -->|"performs actions"| node_external
node_providers -->|"requests inference"| node_external
node_knowledge -.->|"uses knowledge services"| node_external
node_worker -->|"journals events"| node_observability
node_api -->|"journals requests"| node_observability
node_storage -.->|"streams run status"| node_runview
node_requestui -.->|"configures requests"| node_editor

click node_editor "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/frontend/components/workflow-editor.tsx"
click node_requestui "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/frontend/lib/request-routing.ts"
click node_approvalui "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/frontend/components/approval-review.tsx"
click node_api "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/main.py"
click node_workflow "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/models.py"
click node_validator "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/platform_validation.py"
click node_compiler "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/compiler.py"
click node_worker "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/worker.py"
click node_policy "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/execution_policy.py"
click node_agent "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/agent_runtime.py"
click node_accounting "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/accounting_state.py"
click node_registry "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/registry.py"
click node_approvals "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/approvals.py"
click node_tools "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/tool_service.py"
click node_sandbox "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/sandbox.py"
click node_knowledge "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/kb_gateway.py"
click node_providers "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/providers.py"
click node_storage "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/storage.py"
click node_observability "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/observability.py"
click node_runview "https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/frontend/lib/run-status.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_editor,node_requestui,node_approvalui,node_runview toneBlue
class node_api,node_workflow,node_validator,node_compiler toneAmber
class node_worker,node_policy,node_agent,node_accounting toneMint
class node_registry,node_approvals,node_tools,node_sandbox,node_knowledge,node_providers toneRose
class node_storage,node_observability,node_user,node_external toneIndigo
```

## Components

### Workflow studio

- [Workflow editor](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/frontend/components/workflow-editor.tsx): `frontend/components/workflow-editor.tsx`
- [Request routing UI](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/frontend/lib/request-routing.ts): `frontend/lib/request-routing.ts`
- [Approval review](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/frontend/components/approval-review.tsx): `frontend/components/approval-review.tsx`
- [Run status UI](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/frontend/lib/run-status.ts): `frontend/lib/run-status.ts`

### API and compilation

- [FastAPI](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/main.py): `backend/app/main.py`
- [Workflow model](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/models.py): `backend/app/models.py`
- [Graph validation](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/platform_validation.py): `backend/app/platform_validation.py`
- [Graph compiler](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/compiler.py): `backend/app/compiler.py`

### Durable execution

- [Durable worker](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/worker.py): `backend/app/worker.py`
- [Execution policy](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/execution_policy.py): `backend/app/execution_policy.py`
- [Agent runtime](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/agent_runtime.py): `backend/app/agent_runtime.py`
- [Token accounting](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/accounting_state.py): `backend/app/accounting_state.py`

### Workflow capabilities

- [Node registry](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/registry.py): `backend/app/registry.py`
- [Write approvals](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/approvals.py): `backend/app/approvals.py`
- [Tool adapters](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/tool_service.py): `backend/app/tool_service.py`
- [Python sandbox](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/sandbox.py): `backend/app/sandbox.py`
- [Knowledge services](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/kb_gateway.py): `backend/app/kb_gateway.py`
- [Model providers](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/providers.py): `backend/app/providers.py`

### Persistence and operations

- [Relational store](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/storage.py): `backend/app/storage.py`
- [Run observability](https://github.com/soumithreddy6/enterprise-no-code-agentic-ai-workflow-platform/blob/main/backend/app/observability.py): `backend/app/observability.py`

### Other components

- **Workflow author**
- **External systems**

## Connections

- Workflow author → Workflow editor: designs
- Workflow editor → FastAPI: submits workflow
- FastAPI → Workflow model: parses (evidence: `backend/app/main.py`)
- FastAPI → Graph validation: validates (evidence: `backend/app/main.py`)
- FastAPI → Graph compiler: compiles (evidence: `backend/app/main.py`)
- Graph compiler → Workflow model: consumes model (evidence: `backend/app/compiler.py`)
- Graph compiler → Node registry: uses node contracts (evidence: `backend/app/compiler.py`)
- FastAPI → Relational store: stores runs (evidence: `backend/app/main.py`)
- FastAPI → Durable worker: starts worker (evidence: `backend/app/main.py`)
- Durable worker → Relational store: claims and checkpoints (evidence: `backend/app/worker.py`)
- Durable worker → Graph compiler: executes graph (evidence: `backend/app/worker.py`)
- Durable worker → Execution policy: applies policy (evidence: `backend/app/worker.py`)
- Durable worker → Token accounting: tracks spend (evidence: `backend/app/worker.py`)
- Durable worker → Agent runtime: runs agents
- Agent runtime → Model providers: calls models
- Agent runtime → Tool adapters: invokes tools
- Agent runtime → Knowledge services: retrieves documents
- Agent runtime → Python sandbox: runs Python
- Durable worker → Write approvals: pauses for review (evidence: `backend/app/worker.py`)
- Write approvals → Relational store: persists decisions (evidence: `backend/app/approvals.py`)
- Workflow author → Approval review: reviews action
- Approval review → FastAPI: submits decision
- Tool adapters → External systems: performs actions
- Model providers → External systems: requests inference
- Knowledge services → External systems: uses knowledge services
- Durable worker → Run observability: journals events (evidence: `backend/app/worker.py`)
- FastAPI → Run observability: journals requests (evidence: `backend/app/main.py`)
- Relational store → Run status UI: streams run status
- Request routing UI → Workflow editor: configures requests
