# mintplex-labs/anything-llm architecture

> Architecture diagram of the GitHub repository mintplex-labs/anything-llm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mintplex-labs/anything-llm
- Repository: https://github.com/mintplex-labs/anything-llm

## Overview

AnythingLLM is a multi-user AI application for chatting with documents, configuring model providers, and using agents. The main workflow starts with a user uploading or connecting documents, which the collector parses and the server embeds for workspace retrieval; chat requests then reach server-side chat handling and return model-generated responses to the frontend. The README also documents model routing, memories, scheduled tasks, agent tools, and integrations. Some subsystem links below rely on README descriptions because their implementation files were not sampled.

Main entry points: [`collector/index.js`](https://github.com/mintplex-labs/anything-llm/blob/master/collector/index.js) (Collector API), [`server/utils/chats/apiChatHandler.js`](https://github.com/mintplex-labs/anything-llm/blob/master/server/utils/chats/apiChatHandler.js) (Chat handler), [`server/index.js`](https://github.com/mintplex-labs/anything-llm/blob/master/server/index.js) (HTTP application), [`server/utils/router/index.js`](https://github.com/mintplex-labs/anything-llm/blob/master/server/utils/router/index.js) (Model routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_chat_ui["Workspace chat<br/>[index.jsx]"]
  node_document_ui["Document management<br/>[index.jsx]"]
  node_connectors_ui["Connector settings<br/>[index.jsx]"]
end

subgraph group_server["Server and chat"]
  node_server_app["HTTP application<br/>[index.js]"]
  node_chat_handler["Chat handler<br/>[apiChatHandler.js]"]
  node_model_router["Model routing<br/>[index.js]"]
  node_router_config["Router configuration<br/>[modelRouter.js]"]
end

subgraph group_knowledge["Document pipeline"]
  node_collector_app["Collector API<br/>[index.js]"]
  node_file_parser["File conversion<br/>[index.js]"]
  node_link_parser["Link processing<br/>[index.js]"]
  node_text_normalizer["Text normalization<br/>[index.js]"]
  node_connector_loaders["Data connectors"]
  node_embedding_worker["Embedding worker"]
end

subgraph group_models["AI and retrieval"]
  node_vector_store[("Vector database<br/>[index.js]")]
  node_model_providers["Model providers<br/>[index.js]"]
end

subgraph group_capabilities["Workspace capabilities"]
  node_agent_tools["Agents and tools"]
  node_memories["Workspace memories"]
  node_scheduled_tasks["Scheduled tasks"]
end

node_user(("User"))
node_external_sources(("External sources"))

node_user -->|"submits prompts"| node_chat_ui
node_user -->|"uploads documents"| node_document_ui
node_user -->|"configures sources"| node_connectors_ui
node_chat_ui -.->|"sends chat requests"| node_server_app
node_server_app -->|"routes chat"| node_chat_handler
node_chat_handler -->|"selects model"| node_model_router
node_model_router -.->|"dispatches inference"| node_model_providers
node_chat_handler -.->|"retrieves context"| node_vector_store
node_chat_handler -->|"invokes agents"| node_agent_tools
node_model_router -.->|"uses routing rules"| node_router_config
node_document_ui -.->|"uploads files"| node_server_app
node_server_app -.->|"requests processing"| node_collector_app
node_collector_app -->|"processes files"| node_file_parser
node_collector_app -->|"processes links"| node_link_parser
node_file_parser -.->|"produces document text"| node_text_normalizer
node_link_parser -.->|"produces document text"| node_text_normalizer
node_connectors_ui -.->|"requests source loads"| node_collector_app
node_external_sources -.->|"provides content"| node_connector_loaders
node_connector_loaders -.->|"loads source data"| node_collector_app
node_collector_app -.->|"hands off documents"| node_embedding_worker
node_embedding_worker -->|"stores embeddings"| node_vector_store
node_chat_handler -.->|"supports personalization"| node_memories
node_agent_tools -.->|"runs scheduled prompts"| node_scheduled_tasks

click node_chat_ui "https://github.com/mintplex-labs/anything-llm/blob/master/frontend/src/components/WorkspaceChat/index.jsx"
click node_document_ui "https://github.com/mintplex-labs/anything-llm/blob/master/frontend/src/components/Modals/ManageWorkspace/Documents/index.jsx"
click node_connectors_ui "https://github.com/mintplex-labs/anything-llm/blob/master/frontend/src/components/Modals/ManageWorkspace/DataConnectors/index.jsx"
click node_server_app "https://github.com/mintplex-labs/anything-llm/blob/master/server/index.js"
click node_chat_handler "https://github.com/mintplex-labs/anything-llm/blob/master/server/utils/chats/apiChatHandler.js"
click node_model_router "https://github.com/mintplex-labs/anything-llm/blob/master/server/utils/router/index.js"
click node_router_config "https://github.com/mintplex-labs/anything-llm/blob/master/server/endpoints/modelRouter.js"
click node_collector_app "https://github.com/mintplex-labs/anything-llm/blob/master/collector/index.js"
click node_file_parser "https://github.com/mintplex-labs/anything-llm/blob/master/collector/processSingleFile/index.js"
click node_link_parser "https://github.com/mintplex-labs/anything-llm/blob/master/collector/processLink/index.js"
click node_text_normalizer "https://github.com/mintplex-labs/anything-llm/blob/master/collector/processRawText/index.js"
click node_connector_loaders "https://github.com/mintplex-labs/anything-llm/tree/master/collector/utils/extensions"
click node_embedding_worker "https://github.com/mintplex-labs/anything-llm/blob/master/server/jobs/embedding-worker.js"
click node_vector_store "https://github.com/mintplex-labs/anything-llm/blob/master/server/utils/helpers/index.js"
click node_model_providers "https://github.com/mintplex-labs/anything-llm/blob/master/server/utils/helpers/index.js"
click node_agent_tools "https://github.com/mintplex-labs/anything-llm/tree/master/server/utils/agents/aibitat"
click node_memories "https://github.com/mintplex-labs/anything-llm/tree/master/server"
click node_scheduled_tasks "https://github.com/mintplex-labs/anything-llm/tree/master/server"

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_chat_ui,node_document_ui,node_connectors_ui,node_user toneBlue
class node_server_app,node_chat_handler,node_model_router,node_router_config toneAmber
class node_collector_app,node_file_parser,node_link_parser,node_text_normalizer,node_connector_loaders,node_embedding_worker toneMint
class node_vector_store,node_model_providers toneRose
class node_agent_tools,node_memories,node_scheduled_tasks,node_external_sources toneIndigo
```

## Components

### User interface

- [Workspace chat](https://github.com/mintplex-labs/anything-llm/blob/master/frontend/src/components/WorkspaceChat/index.jsx): `frontend/src/components/WorkspaceChat/index.jsx`
- [Document management](https://github.com/mintplex-labs/anything-llm/blob/master/frontend/src/components/Modals/ManageWorkspace/Documents/index.jsx): `frontend/src/components/Modals/ManageWorkspace/Documents/index.jsx`
- [Connector settings](https://github.com/mintplex-labs/anything-llm/blob/master/frontend/src/components/Modals/ManageWorkspace/DataConnectors/index.jsx): `frontend/src/components/Modals/ManageWorkspace/DataConnectors/index.jsx`

### Server and chat

- [HTTP application](https://github.com/mintplex-labs/anything-llm/blob/master/server/index.js): `server/index.js`
- [Chat handler](https://github.com/mintplex-labs/anything-llm/blob/master/server/utils/chats/apiChatHandler.js): `server/utils/chats/apiChatHandler.js`
- [Model routing](https://github.com/mintplex-labs/anything-llm/blob/master/server/utils/router/index.js): `server/utils/router/index.js`
- [Router configuration](https://github.com/mintplex-labs/anything-llm/blob/master/server/endpoints/modelRouter.js): `server/endpoints/modelRouter.js`

### Document pipeline

- [Collector API](https://github.com/mintplex-labs/anything-llm/blob/master/collector/index.js): `collector/index.js`
- [File conversion](https://github.com/mintplex-labs/anything-llm/blob/master/collector/processSingleFile/index.js): `collector/processSingleFile/index.js`
- [Link processing](https://github.com/mintplex-labs/anything-llm/blob/master/collector/processLink/index.js): `collector/processLink/index.js`
- [Text normalization](https://github.com/mintplex-labs/anything-llm/blob/master/collector/processRawText/index.js): `collector/processRawText/index.js`
- [Data connectors](https://github.com/mintplex-labs/anything-llm/tree/master/collector/utils/extensions): `collector/utils/extensions`
- [Embedding worker](https://github.com/mintplex-labs/anything-llm/blob/master/server/jobs/embedding-worker.js): `server/jobs/embedding-worker.js`

### AI and retrieval

- [Vector database](https://github.com/mintplex-labs/anything-llm/blob/master/server/utils/helpers/index.js): `server/utils/helpers/index.js`
- [Model providers](https://github.com/mintplex-labs/anything-llm/blob/master/server/utils/helpers/index.js): `server/utils/helpers/index.js`

### Workspace capabilities

- [Agents and tools](https://github.com/mintplex-labs/anything-llm/tree/master/server/utils/agents/aibitat): `server/utils/agents/aibitat`
- [Workspace memories](https://github.com/mintplex-labs/anything-llm/tree/master/server): `server`
- [Scheduled tasks](https://github.com/mintplex-labs/anything-llm/tree/master/server): `server`

### Other components

- **User**
- **External sources**

## Connections

- User → Workspace chat: submits prompts
- User → Document management: uploads documents
- User → Connector settings: configures sources
- Workspace chat → HTTP application: sends chat requests
- HTTP application → Chat handler: routes chat (evidence: `server/index.js`)
- Chat handler → Model routing: selects model (evidence: `server/utils/chats/apiChatHandler.js`)
- Model routing → Model providers: dispatches inference
- Chat handler → Vector database: retrieves context (evidence: `server/utils/chats/apiChatHandler.js`)
- Chat handler → Agents and tools: invokes agents (evidence: `server/utils/chats/apiChatHandler.js`)
- Model routing → Router configuration: uses routing rules (evidence: `server/endpoints/modelRouter.js`)
- Document management → HTTP application: uploads files
- HTTP application → Collector API: requests processing
- Collector API → File conversion: processes files (evidence: `collector/index.js`)
- Collector API → Link processing: processes links (evidence: `collector/index.js`)
- File conversion → Text normalization: produces document text
- Link processing → Text normalization: produces document text
- Connector settings → Collector API: requests source loads
- External sources → Data connectors: provides content
- Data connectors → Collector API: loads source data
- Collector API → Embedding worker: hands off documents
- Embedding worker → Vector database: stores embeddings (evidence: `server/jobs/embedding-worker.js`)
- Chat handler → Workspace memories: supports personalization (evidence: `server/utils/chats/apiChatHandler.js`)
- Agents and tools → Scheduled tasks: runs scheduled prompts (evidence: `server/utils/agents/aibitat/plugins/sql-agent/query.js`)
