# atharvakulkarni-07/ai-workflow-builder architecture

> Architecture diagram of the GitHub repository atharvakulkarni-07/ai-workflow-builder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/atharvakulkarni-07/ai-workflow-builder
- Repository: https://github.com/atharvakulkarni-07/ai-workflow-builder

## Overview

AI Workflow Builder is a browser-based visual editor for composing, configuring, and running AI workflows. Users add input, bot, and output nodes, connect them, then run the graph or generate one from a prompt; results appear in output nodes. The client also supports PDF extraction, speech input, and workflow save/load/import/export. Relationships follow the sampled Playground, workflow engine, and service code; README-documented capabilities are included, but unsampled server internals are not inferred.

Main entry points: [`client/ai-workflow-builder/src/components/Playground/Playground.jsx`](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/Playground/Playground.jsx) (Workflow playground), [`client/ai-workflow-builder/src/services/aiService.js`](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/services/aiService.js) (AI service client), [`client/ai-workflow-builder/src/App.jsx`](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/App.jsx) (Application shell), [`client/ai-workflow-builder/src/services/workflowEngine.js`](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/services/workflowEngine.js) (Workflow engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editor["Workflow editor"]
  node_app["Application shell<br/>[App.jsx]"]
  node_playground["Workflow playground<br/>[Playground.jsx]"]
  node_sidebar["Node palette<br/>[Sidebar.jsx]"]
  node_botnode["Bot node<br/>[BotNode.jsx]"]
  node_config["Bot configuration<br/>[ConfigModal.jsx]"]
  node_validation["Connection validation<br/>[validation.js]"]
  node_boundary["Error boundary<br/>[ErrorBoundary.jsx]"]
end

subgraph group_execution["Execution and inputs"]
  node_inputnode["Input node<br/>[InputNode.jsx]"]
  node_outputnode["Output node<br/>[OutputNode.jsx]"]
  node_engine["Workflow engine<br/>[workflowEngine.js]"]
  node_bots["Bot catalog<br/>[aiBots.js]"]
  node_pdf["PDF extraction<br/>[pdfUtils.js]"]
  node_speech["Speech input<br/>[useSpeechInput.js]"]
end

subgraph group_services["AI integrations"]
  node_aiservice["AI service client<br/>[aiService.js]"]
end

subgraph group_state["Workflow state"]
  node_persistence["Workflow persistence"]
  node_localstorage[("Browser local storage")]
end

node_user(("Workflow author"))
node_openrouter{{"OpenRouter"}}
node_pollinations{{"Pollinations image API"}}
node_tts{{"TTS API"}}
node_browser_speech{{"Web Speech API"}}

node_user -->|"uses"| node_app
node_app -->|"renders"| node_sidebar
node_app -->|"renders"| node_playground
node_app -->|"wraps with"| node_boundary
node_playground -->|"renders"| node_botnode
node_playground -->|"renders"| node_inputnode
node_playground -->|"renders"| node_outputnode
node_playground -->|"opens"| node_config
node_playground -->|"validates links"| node_validation
node_playground -->|"builds bot nodes"| node_bots
node_sidebar -->|"lists bots"| node_bots
node_playground -->|"runs graph"| node_engine
node_engine -->|"returns results"| node_playground
node_engine -->|"extracts PDF text"| node_pdf
node_engine -->|"requests bot processing"| node_aiservice
node_playground -->|"generates workflows"| node_aiservice
node_aiservice -->|"requests chat completion"| node_openrouter
node_aiservice -->|"creates image URL"| node_pollinations
node_aiservice -->|"requests speech"| node_tts
node_playground -->|"manages workflows"| node_persistence
node_persistence -->|"reads and writes"| node_localstorage
node_playground -->|"captures prompt speech"| node_speech
node_speech -->|"uses recognition"| node_browser_speech

click node_app "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/App.jsx"
click node_playground "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/Playground/Playground.jsx"
click node_sidebar "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/Sidebar/Sidebar.jsx"
click node_botnode "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/BotNode/BotNode.jsx"
click node_config "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/BotNode/ConfigModal.jsx"
click node_inputnode "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/InputNode/InputNode.jsx"
click node_outputnode "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/OutputNode/OutputNode.jsx"
click node_engine "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/services/workflowEngine.js"
click node_validation "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/constants/validation.js"
click node_bots "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/data/aiBots.js"
click node_pdf "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/utils/pdfUtils.js"
click node_speech "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/hooks/useSpeechInput.js"
click node_persistence "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/hooks/useWorkflowPersistence.js"
click node_aiservice "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/services/aiService.js"
click node_boundary "https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/ErrorBoundary/ErrorBoundary.jsx"

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_app,node_playground,node_sidebar,node_botnode,node_config,node_validation,node_boundary toneBlue
class node_inputnode,node_outputnode,node_engine,node_bots,node_pdf,node_speech toneAmber
class node_aiservice,node_openrouter,node_pollinations,node_tts,node_browser_speech toneMint
class node_persistence,node_localstorage toneRose
class node_user toneIndigo
```

## Components

### Workflow editor

- [Application shell](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/App.jsx): `client/ai-workflow-builder/src/App.jsx`
- [Workflow playground](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/Playground/Playground.jsx): `client/ai-workflow-builder/src/components/Playground/Playground.jsx`
- [Node palette](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/Sidebar/Sidebar.jsx): `client/ai-workflow-builder/src/components/Sidebar/Sidebar.jsx`
- [Bot node](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/BotNode/BotNode.jsx): `client/ai-workflow-builder/src/components/BotNode/BotNode.jsx`
- [Bot configuration](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/BotNode/ConfigModal.jsx): `client/ai-workflow-builder/src/components/BotNode/ConfigModal.jsx`
- [Connection validation](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/constants/validation.js): `client/ai-workflow-builder/src/constants/validation.js`
- [Error boundary](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/ErrorBoundary/ErrorBoundary.jsx): `client/ai-workflow-builder/src/components/ErrorBoundary/ErrorBoundary.jsx`

### Execution and inputs

- [Input node](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/InputNode/InputNode.jsx): `client/ai-workflow-builder/src/components/InputNode/InputNode.jsx`
- [Output node](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/components/OutputNode/OutputNode.jsx): `client/ai-workflow-builder/src/components/OutputNode/OutputNode.jsx`
- [Workflow engine](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/services/workflowEngine.js): `client/ai-workflow-builder/src/services/workflowEngine.js`
- [Bot catalog](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/data/aiBots.js): `client/ai-workflow-builder/src/data/aiBots.js`
- [PDF extraction](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/utils/pdfUtils.js): `client/ai-workflow-builder/src/utils/pdfUtils.js`
- [Speech input](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/hooks/useSpeechInput.js): `client/ai-workflow-builder/src/hooks/useSpeechInput.js`

### AI integrations

- [AI service client](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/services/aiService.js): `client/ai-workflow-builder/src/services/aiService.js`

### Workflow state

- [Workflow persistence](https://github.com/atharvakulkarni-07/ai-workflow-builder/blob/main/client/ai-workflow-builder/src/hooks/useWorkflowPersistence.js): `client/ai-workflow-builder/src/hooks/useWorkflowPersistence.js`
- **Browser local storage**

### Other components

- **Workflow author**
- **OpenRouter**
- **Pollinations image API**
- **TTS API**
- **Web Speech API**

## Connections

- Workflow author → Application shell: uses
- Application shell → Node palette: renders (evidence: `client/ai-workflow-builder/src/App.jsx`)
- Application shell → Workflow playground: renders (evidence: `client/ai-workflow-builder/src/App.jsx`)
- Application shell → Error boundary: wraps with (evidence: `client/ai-workflow-builder/src/App.jsx`)
- Workflow playground → Bot node: renders (evidence: `client/ai-workflow-builder/src/components/Playground/Playground.jsx`)
- Workflow playground → Input node: renders (evidence: `client/ai-workflow-builder/src/components/Playground/Playground.jsx`)
- Workflow playground → Output node: renders (evidence: `client/ai-workflow-builder/src/components/Playground/Playground.jsx`)
- Workflow playground → Bot configuration: opens (evidence: `client/ai-workflow-builder/src/components/Playground/Playground.jsx`)
- Workflow playground → Connection validation: validates links (evidence: `client/ai-workflow-builder/src/components/Playground/Playground.jsx`)
- Workflow playground → Bot catalog: builds bot nodes (evidence: `client/ai-workflow-builder/src/components/Playground/Playground.jsx`)
- Node palette → Bot catalog: lists bots (evidence: `client/ai-workflow-builder/src/components/Sidebar/Sidebar.jsx`)
- Workflow playground → Workflow engine: runs graph (evidence: `client/ai-workflow-builder/src/components/Playground/Playground.jsx`)
- Workflow engine → Workflow playground: returns results (evidence: `client/ai-workflow-builder/src/components/Playground/Playground.jsx`)
- Workflow engine → PDF extraction: extracts PDF text (evidence: `client/ai-workflow-builder/src/services/workflowEngine.js`)
- Workflow engine → AI service client: requests bot processing (evidence: `client/ai-workflow-builder/src/services/workflowEngine.js`)
- Workflow playground → AI service client: generates workflows (evidence: `client/ai-workflow-builder/src/components/Playground/Playground.jsx`)
- AI service client → OpenRouter: requests chat completion (evidence: `client/ai-workflow-builder/src/services/aiService.js`)
- AI service client → Pollinations image API: creates image URL (evidence: `client/ai-workflow-builder/src/services/aiService.js`)
- AI service client → TTS API: requests speech (evidence: `client/ai-workflow-builder/src/services/aiService.js`)
- Workflow playground → Workflow persistence: manages workflows (evidence: `client/ai-workflow-builder/src/components/Playground/Playground.jsx`)
- Workflow persistence → Browser local storage: reads and writes (evidence: `client/ai-workflow-builder/src/hooks/useWorkflowPersistence.js`)
- Workflow playground → Speech input: captures prompt speech (evidence: `client/ai-workflow-builder/src/components/Playground/Playground.jsx`)
- Speech input → Web Speech API: uses recognition (evidence: `client/ai-workflow-builder/src/hooks/useSpeechInput.js`)
