# alexalkhatib/ai-automation-n8n architecture

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

- Interactive diagram: https://gitdiagram.com/alexalkhatib/ai-automation-n8n
- Repository: https://github.com/alexalkhatib/ai-automation-n8n

## Overview

This repository is an importable library of 16 n8n workflows across 10 progressive modules, rather than an application with its own runtime. The user’s path is to import workflows into n8n, configure provider credentials, and execute an automation. The graph preserves the documented agent, media, orchestration, RAG, MCP, marketing, and operations branches. Workflow JSON was not sampled, so detailed node-level behavior and most inter-workflow links are not asserted; documented orchestration links are shown from the README.

Main entry points: [`workflows/09-marketing-team/marketing-team-orchestrator.json`](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/09-marketing-team/marketing-team-orchestrator.json) (Marketing Orchestrator), [`workflows/05-subworkflows/image-to-video-orchestrator.json`](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/05-subworkflows/image-to-video-orchestrator.json) (Image Video Orchestrator), [`workflows/01-email-agent/email-agent.json`](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/01-email-agent/email-agent.json) (Email Agent), [`workflows/02-research-agent/daily-ai-news-digest.json`](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/02-research-agent/daily-ai-news-digest.json) (Daily News Digest)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agents["AI Agents"]
  node_email["Email Agent<br/>[email-agent.json]"]
  node_research["Daily News Digest"]
  node_slack["Slack AI Teammate"]
end

subgraph group_media["Media Workflows"]
  node_image["Text To Image<br/>[text-to-image.json]"]
  node_video["Text To Video<br/>[text-to-video.json]"]
end

subgraph group_orchestration["Orchestration"]
  node_video_orchestrator["Image Video Orchestrator"]
  node_video_subworkflow["Video Subworkflow"]
end

subgraph group_knowledge["Knowledge And MCP"]
  node_ingestion["Knowledge Ingestion"]
  node_rag["RAG Support Agent"]
  node_mcp["MCP Lab<br/>[mcp-lab.json]"]
end

subgraph group_production["Marketing And Ops"]
  node_marketing["Marketing Orchestrator"]
  node_marketing_image["Image Subworkflow"]
  node_marketing_video["Video Subworkflow"]
  node_caption["Caption Copywriter"]
  node_blogpost["Blogpost Copywriter"]
  node_error_handler["Error Handler<br/>[error-handler.json]"]
end

node_user(("Workflow User"))
node_n8n["n8n Instance"]
node_pinecone[("Pinecone Index")]
node_providers["External Providers"]

node_user -->|"imports workflows"| node_n8n
node_n8n -->|"executes"| node_email
node_n8n -->|"executes"| node_research
node_n8n -->|"executes"| node_image
node_n8n -->|"executes"| node_video
node_n8n -->|"executes"| node_video_orchestrator
node_n8n -->|"executes"| node_slack
node_n8n -->|"executes"| node_ingestion
node_n8n -->|"executes"| node_rag
node_n8n -->|"executes"| node_mcp
node_n8n -->|"executes"| node_marketing
node_n8n -->|"executes"| node_error_handler
node_video_orchestrator -->|"calls"| node_video_subworkflow
node_video_orchestrator -->|"notifies and logs"| node_providers
node_video_subworkflow -->|"generates video"| node_providers
node_ingestion -->|"indexes knowledge"| node_pinecone
node_rag -->|"retrieves knowledge"| node_pinecone
node_mcp -->|"serves and calls MCP"| node_providers
node_marketing -->|"calls"| node_marketing_image
node_marketing -->|"calls"| node_marketing_video
node_marketing -->|"calls"| node_caption
node_marketing -->|"calls"| node_blogpost
node_marketing -->|"uses AI services"| node_providers
node_email -->|"uses email and AI"| node_providers
node_research -->|"searches and emails"| node_providers
node_image -->|"generates images"| node_providers
node_video -->|"generates video"| node_providers
node_slack -->|"integrates Slack"| node_providers
node_error_handler -->|"alerts Slack"| node_providers

click node_email "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/01-email-agent/email-agent.json"
click node_research "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/02-research-agent/daily-ai-news-digest.json"
click node_image "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/03-text-to-image/text-to-image.json"
click node_video "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/04-text-to-video/text-to-video.json"
click node_video_orchestrator "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/05-subworkflows/image-to-video-orchestrator.json"
click node_video_subworkflow "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/05-subworkflows/image-to-video-subworkflow.json"
click node_slack "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/06-slack-agent/slack-ai-teammate.json"
click node_ingestion "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/07-rag-pinecone/knowledge-ingestion.json"
click node_rag "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/07-rag-pinecone/rag-support-agent.json"
click node_mcp "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/08-mcp/mcp-lab.json"
click node_marketing "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/09-marketing-team/marketing-team-orchestrator.json"
click node_marketing_image "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/09-marketing-team/text-to-image-subworkflow.json"
click node_marketing_video "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/09-marketing-team/text-to-video-subworkflow.json"
click node_caption "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/09-marketing-team/caption-copywriter-subworkflow.json"
click node_blogpost "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/09-marketing-team/blogpost-copywriter-subworkflow.json"
click node_error_handler "https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/10-production/error-handler.json"

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_email,node_research,node_slack,node_user toneBlue
class node_image,node_video,node_pinecone toneAmber
class node_video_orchestrator,node_video_subworkflow toneMint
class node_ingestion,node_rag,node_mcp toneRose
class node_marketing,node_marketing_image,node_marketing_video,node_caption,node_blogpost,node_error_handler,node_n8n,node_providers toneIndigo
```

## Components

### AI Agents

- [Email Agent](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/01-email-agent/email-agent.json): `workflows/01-email-agent/email-agent.json`
- [Daily News Digest](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/02-research-agent/daily-ai-news-digest.json): `workflows/02-research-agent/daily-ai-news-digest.json`
- [Slack AI Teammate](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/06-slack-agent/slack-ai-teammate.json): `workflows/06-slack-agent/slack-ai-teammate.json`

### Media Workflows

- [Text To Image](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/03-text-to-image/text-to-image.json): `workflows/03-text-to-image/text-to-image.json`
- [Text To Video](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/04-text-to-video/text-to-video.json): `workflows/04-text-to-video/text-to-video.json`

### Orchestration

- [Image Video Orchestrator](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/05-subworkflows/image-to-video-orchestrator.json): `workflows/05-subworkflows/image-to-video-orchestrator.json`
- [Video Subworkflow](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/05-subworkflows/image-to-video-subworkflow.json): `workflows/05-subworkflows/image-to-video-subworkflow.json`

### Knowledge And MCP

- [Knowledge Ingestion](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/07-rag-pinecone/knowledge-ingestion.json): `workflows/07-rag-pinecone/knowledge-ingestion.json`
- [RAG Support Agent](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/07-rag-pinecone/rag-support-agent.json): `workflows/07-rag-pinecone/rag-support-agent.json`
- [MCP Lab](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/08-mcp/mcp-lab.json): `workflows/08-mcp/mcp-lab.json`

### Marketing And Ops

- [Marketing Orchestrator](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/09-marketing-team/marketing-team-orchestrator.json): `workflows/09-marketing-team/marketing-team-orchestrator.json`
- [Image Subworkflow](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/09-marketing-team/text-to-image-subworkflow.json): `workflows/09-marketing-team/text-to-image-subworkflow.json`
- [Video Subworkflow](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/09-marketing-team/text-to-video-subworkflow.json): `workflows/09-marketing-team/text-to-video-subworkflow.json`
- [Caption Copywriter](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/09-marketing-team/caption-copywriter-subworkflow.json): `workflows/09-marketing-team/caption-copywriter-subworkflow.json`
- [Blogpost Copywriter](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/09-marketing-team/blogpost-copywriter-subworkflow.json): `workflows/09-marketing-team/blogpost-copywriter-subworkflow.json`
- [Error Handler](https://github.com/alexalkhatib/ai-automation-n8n/blob/main/workflows/10-production/error-handler.json): `workflows/10-production/error-handler.json`

### Other components

- **Workflow User**
- **n8n Instance**
- **Pinecone Index**
- **External Providers**

## Connections

- Workflow User → n8n Instance: imports workflows (evidence: `README.md`)
- n8n Instance → Email Agent: executes (evidence: `README.md`)
- n8n Instance → Daily News Digest: executes (evidence: `README.md`)
- n8n Instance → Text To Image: executes (evidence: `README.md`)
- n8n Instance → Text To Video: executes (evidence: `README.md`)
- n8n Instance → Image Video Orchestrator: executes (evidence: `README.md`)
- n8n Instance → Slack AI Teammate: executes (evidence: `README.md`)
- n8n Instance → Knowledge Ingestion: executes (evidence: `README.md`)
- n8n Instance → RAG Support Agent: executes (evidence: `README.md`)
- n8n Instance → MCP Lab: executes (evidence: `README.md`)
- n8n Instance → Marketing Orchestrator: executes (evidence: `README.md`)
- n8n Instance → Error Handler: executes (evidence: `README.md`)
- Image Video Orchestrator → Video Subworkflow: calls (evidence: `README.md`)
- Image Video Orchestrator → External Providers: notifies and logs (evidence: `README.md`)
- Video Subworkflow → External Providers: generates video (evidence: `README.md`)
- Knowledge Ingestion → Pinecone Index: indexes knowledge (evidence: `README.md`)
- RAG Support Agent → Pinecone Index: retrieves knowledge (evidence: `README.md`)
- MCP Lab → External Providers: serves and calls MCP (evidence: `README.md`)
- Marketing Orchestrator → Image Subworkflow: calls (evidence: `README.md`)
- Marketing Orchestrator → Video Subworkflow: calls (evidence: `README.md`)
- Marketing Orchestrator → Caption Copywriter: calls (evidence: `README.md`)
- Marketing Orchestrator → Blogpost Copywriter: calls (evidence: `README.md`)
- Marketing Orchestrator → External Providers: uses AI services (evidence: `README.md`)
- Email Agent → External Providers: uses email and AI (evidence: `README.md`)
- Daily News Digest → External Providers: searches and emails (evidence: `README.md`)
- Text To Image → External Providers: generates images (evidence: `README.md`)
- Text To Video → External Providers: generates video (evidence: `README.md`)
- Slack AI Teammate → External Providers: integrates Slack (evidence: `README.md`)
- Error Handler → External Providers: alerts Slack (evidence: `README.md`)