# langchain-ai/langchain architecture

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

- Interactive diagram: https://gitdiagram.com/langchain-ai/langchain
- Repository: https://github.com/langchain-ai/langchain
- Video tour (about a minute): https://gitdiagram.com/langchain-ai/langchain/video

## Overview

LangChain is a Python framework for composing interoperable LLM applications and agents. The principal workflow is an application invoking a model through a standard interface and receiving generated text or messages; larger applications can add agent orchestration, tools, retrieval, and data augmentation. Core abstractions live in langchain_core, while the repository also includes classic and newer agent packages and provider integrations. Some subsystem links below are documented capabilities rather than inspected call paths; those are marked dashed with no evidence path.

Main entry points: [`libs/core/langchain_core/language_models/base.py`](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/language_models/base.py) (Model interface), [`libs/core/langchain_core/language_models/llms.py`](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/language_models/llms.py) (Text LLMs), [`libs/core/langchain_core/runnables/base.py`](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/runnables/base.py) (Runnable workflows), [`libs/langchain_v1/langchain/agents/factory.py`](https://github.com/langchain-ai/langchain/blob/master/libs/langchain_v1/langchain/agents/factory.py) (Agent orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_composition["Composition"]
  node_runnables["Runnable workflows<br/>[base.py]"]
  node_prompts["Prompt templates"]
  node_parsers["Output parsing"]
end

subgraph group_models["Models"]
  node_model_api["Model interface<br/>[base.py]"]
  node_chat_models["Chat models<br/>[chat_models.py]"]
  node_llms["Text LLMs<br/>[llms.py]"]
  node_outputs["Model results"]
end

subgraph group_knowledge["Data and retrieval"]
  node_documents["Documents<br/>[base.py]"]
  node_loaders["Document loaders"]
  node_splitters["Text splitting"]
  node_embeddings["Embeddings<br/>[embeddings.py]"]
  node_vectorstores[("Vector stores<br/>[base.py]")]
  node_retrievers["Retrievers<br/>[retrievers.py]"]
end

subgraph group_agents["Agent capabilities"]
  node_agents["Agent orchestration<br/>[factory.py]"]
  node_middleware["Agent middleware<br/>[types.py]"]
  node_classic_agents["Classic agents<br/>[agent.py]"]
  node_tools["Tools and toolkits<br/>[base.py]"]
end

subgraph group_operations["Observability and integrations"]
  node_provider_models["Provider integrations"]
  node_callbacks["Callback managers<br/>[manager.py]"]
  node_tracing["LangSmith tracing<br/>[langchain.py]"]
end

node_developer(("Application developer"))

node_developer -->|"composes"| node_runnables
node_developer -->|"invokes"| node_model_api
node_model_api -.->|"specializes"| node_chat_models
node_model_api -.->|"specializes"| node_llms
node_llms -->|"returns"| node_outputs
node_llms -->|"configures"| node_callbacks
node_llms -->|"implements"| node_runnables
node_runnables -.->|"composes"| node_prompts
node_runnables -.->|"composes"| node_parsers
node_provider_models -.->|"implements"| node_model_api
node_loaders -.->|"produces"| node_documents
node_documents -.->|"transforms"| node_splitters
node_embeddings -.->|"indexes"| node_vectorstores
node_vectorstores -.->|"retrieves"| node_retrievers
node_agents -.->|"applies"| node_middleware
node_agents -.->|"uses"| node_model_api
node_agents -.->|"uses"| node_tools
node_classic_agents -.->|"uses"| node_tools
node_callbacks -->|"dispatches"| node_tracing

click node_runnables "https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/runnables/base.py"
click node_prompts "https://github.com/langchain-ai/langchain/tree/master/libs/core/langchain_core/prompts"
click node_parsers "https://github.com/langchain-ai/langchain/tree/master/libs/core/langchain_core/output_parsers"
click node_model_api "https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/language_models/base.py"
click node_chat_models "https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/language_models/chat_models.py"
click node_llms "https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/language_models/llms.py"
click node_outputs "https://github.com/langchain-ai/langchain/tree/master/libs/core/langchain_core/outputs"
click node_provider_models "https://github.com/langchain-ai/langchain/tree/master/libs/partners"
click node_documents "https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/documents/base.py"
click node_loaders "https://github.com/langchain-ai/langchain/tree/master/libs/core/langchain_core/document_loaders"
click node_splitters "https://github.com/langchain-ai/langchain/tree/master/libs/text-splitters/langchain_text_splitters"
click node_embeddings "https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/embeddings/embeddings.py"
click node_vectorstores "https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/vectorstores/base.py"
click node_retrievers "https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/retrievers.py"
click node_agents "https://github.com/langchain-ai/langchain/blob/master/libs/langchain_v1/langchain/agents/factory.py"
click node_middleware "https://github.com/langchain-ai/langchain/blob/master/libs/langchain_v1/langchain/agents/middleware/types.py"
click node_classic_agents "https://github.com/langchain-ai/langchain/blob/master/libs/langchain/langchain_classic/agents/agent.py"
click node_tools "https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/tools/base.py"
click node_callbacks "https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/callbacks/manager.py"
click node_tracing "https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/tracers/langchain.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_runnables,node_prompts,node_parsers toneBlue
class node_model_api,node_chat_models,node_llms,node_outputs toneAmber
class node_documents,node_loaders,node_splitters,node_embeddings,node_vectorstores,node_retrievers toneMint
class node_agents,node_middleware,node_classic_agents,node_tools toneRose
class node_provider_models,node_callbacks,node_tracing,node_developer toneIndigo
```

## Components

### Composition

- [Runnable workflows](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/runnables/base.py): `libs/core/langchain_core/runnables/base.py`
- [Prompt templates](https://github.com/langchain-ai/langchain/tree/master/libs/core/langchain_core/prompts): `libs/core/langchain_core/prompts`
- [Output parsing](https://github.com/langchain-ai/langchain/tree/master/libs/core/langchain_core/output_parsers): `libs/core/langchain_core/output_parsers`

### Models

- [Model interface](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/language_models/base.py): `libs/core/langchain_core/language_models/base.py`
- [Chat models](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/language_models/chat_models.py): `libs/core/langchain_core/language_models/chat_models.py`
- [Text LLMs](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/language_models/llms.py): `libs/core/langchain_core/language_models/llms.py`
- [Model results](https://github.com/langchain-ai/langchain/tree/master/libs/core/langchain_core/outputs): `libs/core/langchain_core/outputs`

### Data and retrieval

- [Documents](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/documents/base.py): `libs/core/langchain_core/documents/base.py`
- [Document loaders](https://github.com/langchain-ai/langchain/tree/master/libs/core/langchain_core/document_loaders): `libs/core/langchain_core/document_loaders`
- [Text splitting](https://github.com/langchain-ai/langchain/tree/master/libs/text-splitters/langchain_text_splitters): `libs/text-splitters/langchain_text_splitters`
- [Embeddings](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/embeddings/embeddings.py): `libs/core/langchain_core/embeddings/embeddings.py`
- [Vector stores](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/vectorstores/base.py): `libs/core/langchain_core/vectorstores/base.py`
- [Retrievers](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/retrievers.py): `libs/core/langchain_core/retrievers.py`

### Agent capabilities

- [Agent orchestration](https://github.com/langchain-ai/langchain/blob/master/libs/langchain_v1/langchain/agents/factory.py): `libs/langchain_v1/langchain/agents/factory.py`
- [Agent middleware](https://github.com/langchain-ai/langchain/blob/master/libs/langchain_v1/langchain/agents/middleware/types.py): `libs/langchain_v1/langchain/agents/middleware/types.py`
- [Classic agents](https://github.com/langchain-ai/langchain/blob/master/libs/langchain/langchain_classic/agents/agent.py): `libs/langchain/langchain_classic/agents/agent.py`
- [Tools and toolkits](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/tools/base.py): `libs/core/langchain_core/tools/base.py`

### Observability and integrations

- [Provider integrations](https://github.com/langchain-ai/langchain/tree/master/libs/partners): `libs/partners`
- [Callback managers](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/callbacks/manager.py): `libs/core/langchain_core/callbacks/manager.py`
- [LangSmith tracing](https://github.com/langchain-ai/langchain/blob/master/libs/core/langchain_core/tracers/langchain.py): `libs/core/langchain_core/tracers/langchain.py`

### Other components

- **Application developer**

## Connections

- Application developer → Runnable workflows: composes
- Application developer → Model interface: invokes
- Model interface → Chat models: specializes
- Model interface → Text LLMs: specializes (evidence: `libs/core/langchain_core/language_models/llms.py`)
- Text LLMs → Model results: returns (evidence: `libs/core/langchain_core/language_models/llms.py`)
- Text LLMs → Callback managers: configures (evidence: `libs/core/langchain_core/language_models/llms.py`)
- Text LLMs → Runnable workflows: implements (evidence: `libs/core/langchain_core/language_models/llms.py`)
- Runnable workflows → Prompt templates: composes
- Runnable workflows → Output parsing: composes
- Provider integrations → Model interface: implements
- Document loaders → Documents: produces
- Documents → Text splitting: transforms
- Embeddings → Vector stores: indexes
- Vector stores → Retrievers: retrieves
- Agent orchestration → Agent middleware: applies
- Agent orchestration → Model interface: uses
- Agent orchestration → Tools and toolkits: uses
- Classic agents → Tools and toolkits: uses
- Callback managers → LangSmith tracing: dispatches (evidence: `libs/core/langchain_core/callbacks/manager.py`)
