# akarshvyas/multi-agent-research-system architecture

> Architecture diagram of the GitHub repository akarshvyas/multi-agent-research-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/akarshvyas/multi-agent-research-system
- Repository: https://github.com/akarshvyas/multi-agent-research-system

## Overview

ResearchMind accepts a topic through a Streamlit interface or the standalone pipeline, then searches for sources, scrapes selected content, drafts a report, and critiques it. The agent definitions and prompt chains live in agents.py; tools.py implements Tavily search and page extraction, while agents.py configures the OpenAI model. The interface runs these stages directly; pipeline.py provides a separate command-line workflow. The README is empty, so capabilities and relationships here are based on the sampled source; no persistence layer is shown.

Main entry points: [`app.py`](https://github.com/akarshvyas/multi-agent-research-system/blob/main/app.py) (Research UI), [`pipeline.py`](https://github.com/akarshvyas/multi-agent-research-system/blob/main/pipeline.py) (CLI pipeline), [`agents.py`](https://github.com/akarshvyas/multi-agent-research-system/blob/main/agents.py) (Search agent), [`tools.py`](https://github.com/akarshvyas/multi-agent-research-system/blob/main/tools.py) (Web search tool)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry points"]
  node_streamlit["Research UI<br/>[app.py]"]
  node_cli["CLI pipeline<br/>[pipeline.py]"]
end

subgraph group_research["Research stages"]
  node_search_agent["Search agent<br/>[agents.py]"]
  node_reader_agent["Reader agent<br/>[agents.py]"]
  node_writer["Report writer<br/>[agents.py]"]
  node_critic["Report critic<br/>[agents.py]"]
end

subgraph group_integrations["External integrations"]
  node_search_tool["Web search tool<br/>[tools.py]"]
  node_scrape_tool["Page scraper<br/>[tools.py]"]
  node_openai{{"OpenAI model"}}
  node_tavily{{"Tavily search"}}
end

node_user(("Researcher"))
node_web{{"Web pages"}}

node_user -->|"enters topic"| node_streamlit
node_user -->|"enters topic"| node_cli
node_streamlit -->|"invokes"| node_search_agent
node_streamlit -->|"invokes"| node_reader_agent
node_streamlit -->|"invokes"| node_writer
node_streamlit -->|"invokes"| node_critic
node_cli -->|"invokes"| node_search_agent
node_cli -->|"invokes"| node_reader_agent
node_cli -->|"invokes"| node_writer
node_cli -->|"invokes"| node_critic
node_search_agent -->|"registers tool"| node_search_tool
node_reader_agent -->|"registers tool"| node_scrape_tool
node_search_tool -->|"queries"| node_tavily
node_scrape_tool -->|"fetches page"| node_web
node_search_agent -->|"uses model"| node_openai
node_reader_agent -->|"uses model"| node_openai
node_writer -->|"uses model"| node_openai
node_critic -->|"uses model"| node_openai

click node_streamlit "https://github.com/akarshvyas/multi-agent-research-system/blob/main/app.py"
click node_cli "https://github.com/akarshvyas/multi-agent-research-system/blob/main/pipeline.py"
click node_search_agent "https://github.com/akarshvyas/multi-agent-research-system/blob/main/agents.py"
click node_reader_agent "https://github.com/akarshvyas/multi-agent-research-system/blob/main/agents.py"
click node_writer "https://github.com/akarshvyas/multi-agent-research-system/blob/main/agents.py"
click node_critic "https://github.com/akarshvyas/multi-agent-research-system/blob/main/agents.py"
click node_search_tool "https://github.com/akarshvyas/multi-agent-research-system/blob/main/tools.py"
click node_scrape_tool "https://github.com/akarshvyas/multi-agent-research-system/blob/main/tools.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_streamlit,node_cli toneBlue
class node_search_agent,node_reader_agent,node_writer,node_critic toneAmber
class node_search_tool,node_scrape_tool,node_openai,node_tavily toneMint
class node_user,node_web toneIndigo
```

## Components

### Entry points

- [Research UI](https://github.com/akarshvyas/multi-agent-research-system/blob/main/app.py): `app.py`
- [CLI pipeline](https://github.com/akarshvyas/multi-agent-research-system/blob/main/pipeline.py): `pipeline.py`

### Research stages

- [Search agent](https://github.com/akarshvyas/multi-agent-research-system/blob/main/agents.py): `agents.py`
- [Reader agent](https://github.com/akarshvyas/multi-agent-research-system/blob/main/agents.py): `agents.py`
- [Report writer](https://github.com/akarshvyas/multi-agent-research-system/blob/main/agents.py): `agents.py`
- [Report critic](https://github.com/akarshvyas/multi-agent-research-system/blob/main/agents.py): `agents.py`

### External integrations

- [Web search tool](https://github.com/akarshvyas/multi-agent-research-system/blob/main/tools.py): `tools.py`
- [Page scraper](https://github.com/akarshvyas/multi-agent-research-system/blob/main/tools.py): `tools.py`
- **OpenAI model**
- **Tavily search**

### Other components

- **Researcher**
- **Web pages**

## Connections

- Researcher → Research UI: enters topic (evidence: `app.py`)
- Researcher → CLI pipeline: enters topic (evidence: `pipeline.py`)
- Research UI → Search agent: invokes (evidence: `app.py`)
- Research UI → Reader agent: invokes (evidence: `app.py`)
- Research UI → Report writer: invokes (evidence: `app.py`)
- Research UI → Report critic: invokes (evidence: `app.py`)
- CLI pipeline → Search agent: invokes (evidence: `pipeline.py`)
- CLI pipeline → Reader agent: invokes (evidence: `pipeline.py`)
- CLI pipeline → Report writer: invokes (evidence: `pipeline.py`)
- CLI pipeline → Report critic: invokes (evidence: `pipeline.py`)
- Search agent → Web search tool: registers tool (evidence: `agents.py`)
- Reader agent → Page scraper: registers tool (evidence: `agents.py`)
- Web search tool → Tavily search: queries (evidence: `tools.py`)
- Page scraper → Web pages: fetches page (evidence: `tools.py`)
- Search agent → OpenAI model: uses model (evidence: `agents.py`)
- Reader agent → OpenAI model: uses model (evidence: `agents.py`)
- Report writer → OpenAI model: uses model (evidence: `agents.py`)
- Report critic → OpenAI model: uses model (evidence: `agents.py`)
