# niharj77/collaborative-ai-content-creator-multi-agent-system architecture

> Architecture diagram of the GitHub repository niharj77/collaborative-ai-content-creator-multi-agent-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/niharj77/collaborative-ai-content-creator-multi-agent-system
- Repository: https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system

## Overview

This small Python app produces an article through a `main.py` orchestrator that calls research, drafting, and editing stages in `agents.py`, then prints the result. The implementation uses simulated findings and text, not live AI or search services; README/API references and comments describe intended integrations only. `config.py` defines placeholder keys but is not used by the workflow. The README mentions broader capabilities such as idea generation and fact-checking, but these are not implemented in the sampled source.

Main entry points: [`main.py`](https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/main.py) (Workflow Orchestrator), [`agents.py`](https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/agents.py) (Researcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Workflow"]
  node_orchestrator["Workflow Orchestrator<br/>[main.py]"]
  node_article_output["Printed Article<br/>[main.py]"]
end

subgraph group_agents["Content Agents"]
  node_researcher["Researcher<br/>[agents.py]"]
  node_writer["Writer<br/>[agents.py]"]
  node_editor["Editor<br/>[agents.py]"]
end

subgraph group_configuration["Configuration"]
  node_config["API Key Config<br/>[config.py]"]
end

node_topic_user(("Topic Provider"))
node_web_search["Search API"]
node_llm_service["LLM API"]

node_topic_user -->|"provides topic"| node_orchestrator
node_orchestrator -->|"calls research"| node_researcher
node_researcher -->|"returns findings"| node_orchestrator
node_orchestrator -->|"calls drafting"| node_writer
node_writer -->|"returns draft"| node_orchestrator
node_orchestrator -->|"calls editing"| node_editor
node_editor -->|"returns article"| node_orchestrator
node_orchestrator -->|"prints result"| node_article_output
node_researcher -.->|"would query"| node_web_search
node_writer -.->|"would generate"| node_llm_service
node_editor -.->|"would refine"| node_llm_service

click node_orchestrator "https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/main.py"
click node_researcher "https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/agents.py"
click node_writer "https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/agents.py"
click node_editor "https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/agents.py"
click node_article_output "https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/main.py"
click node_config "https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/config.py"

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_orchestrator,node_article_output toneBlue
class node_researcher,node_writer,node_editor toneAmber
class node_config,node_web_search,node_llm_service toneMint
class node_topic_user toneIndigo
```

## Components

### Workflow

- [Workflow Orchestrator](https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/main.py): `main.py`
- [Printed Article](https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/main.py): `main.py`

### Content Agents

- [Researcher](https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/agents.py): `agents.py`
- [Writer](https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/agents.py): `agents.py`
- [Editor](https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/agents.py): `agents.py`

### Configuration

- [API Key Config](https://github.com/niharj77/collaborative-ai-content-creator-multi-agent-system/blob/main/config.py): `config.py`

### Other components

- **Topic Provider**
- **Search API**
- **LLM API**

## Connections

- Topic Provider → Workflow Orchestrator: provides topic
- Workflow Orchestrator → Researcher: calls research
- Researcher → Workflow Orchestrator: returns findings
- Workflow Orchestrator → Writer: calls drafting
- Writer → Workflow Orchestrator: returns draft
- Workflow Orchestrator → Editor: calls editing
- Editor → Workflow Orchestrator: returns article
- Workflow Orchestrator → Printed Article: prints result
- Researcher → Search API: would query
- Writer → LLM API: would generate
- Editor → LLM API: would refine