# mayooear/ai-pdf-chatbot-langchain architecture

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

- Interactive diagram: https://gitdiagram.com/mayooear/ai-pdf-chatbot-langchain
- Repository: https://github.com/mayooear/ai-pdf-chatbot-langchain

## Overview

This is a PDF-ingestion and question-answering chatbot: users upload PDFs for indexing, then ask questions and receive streamed answers with sources. The README documents the frontend/backend interaction and major capabilities; sampled graph code shows ingestion, routing, retrieval, and response generation. Some frontend-to-backend wiring and integrations are documented rather than visible in the excerpts, so those links cite the README; no unsampled implementation details are assumed.

Main entry points: [`backend/src/retrieval_graph/graph.ts`](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/retrieval_graph/graph.ts) (Query routing and answers), [`backend/src/ingestion_graph/graph.ts`](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/ingestion_graph/graph.ts) (Document ingestion), [`backend/src/shared/retrieval.ts`](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/shared/retrieval.ts) (Vector retrieval), [`frontend/app/page.tsx`](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/frontend/app/page.tsx) (Chat and upload UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Chat interface"]
  node_chatui["Chat and upload UI<br/>[page.tsx]"]
  node_client["LangGraph client<br/>[langgraph-base.ts]"]
end

subgraph group_api["Application endpoints"]
  node_chatapi["Chat endpoint<br/>[route.ts]"]
  node_ingestapi["Ingest endpoint<br/>[route.ts]"]
end

subgraph group_graphs["LangGraph workflows"]
  node_ingest["Document ingestion<br/>[graph.ts]"]
  node_ingeststate["Ingestion state<br/>[state.ts]"]
  node_ingestconfig["Ingestion configuration<br/>[configuration.ts]"]
  node_retrieval["Query routing and answers<br/>[graph.ts]"]
  node_retrievalstate["Query state<br/>[state.ts]"]
  node_retrievalconfig["Query configuration<br/>[configuration.ts]"]
  node_prompts["Routing and answer prompts<br/>[prompts.ts]"]
  node_format["Document formatting<br/>[utils.ts]"]
end

subgraph group_shared["Models and retrieval"]
  node_sharedconfig["Retriever configuration<br/>[configuration.ts]"]
  node_retriever["Vector retrieval<br/>[retrieval.ts]"]
  node_docstate["Document reducer<br/>[state.ts]"]
  node_modelutils["Chat model loader<br/>[utils.ts]"]
end

node_user(("User"))
node_vectorstore[("Supabase vector store")]
node_llm["LLM provider"]

node_user -->|"uses"| node_chatui
node_chatui -->|"uploads PDFs"| node_ingestapi
node_chatui -->|"asks questions"| node_chatapi
node_chatapi -->|"streams answers"| node_client
node_ingestapi -->|"submits documents"| node_client
node_ingestapi -->|"invokes graph"| node_ingest
node_chatapi -->|"invokes graph"| node_retrieval
node_ingest -->|"uses state"| node_ingeststate
node_ingest -->|"loads configuration"| node_ingestconfig
node_ingest -->|"reduces documents"| node_docstate
node_ingest -->|"adds documents"| node_retriever
node_ingeststate -->|"reduces state"| node_docstate
node_retrieval -->|"uses state"| node_retrievalstate
node_retrieval -->|"loads configuration"| node_retrievalconfig
node_retrieval -->|"retrieves documents"| node_retriever
node_retrieval -->|"formats context"| node_format
node_retrieval -->|"uses prompts"| node_prompts
node_retrieval -->|"loads chat model"| node_modelutils
node_retrievalstate -->|"reduces documents"| node_docstate
node_ingestconfig -->|"extends configuration"| node_sharedconfig
node_retrievalconfig -->|"extends configuration"| node_sharedconfig
node_retriever -->|"validates configuration"| node_sharedconfig
node_retriever -->|"reads and writes embeddings"| node_vectorstore
node_retriever -->|"creates embeddings"| node_llm
node_modelutils -->|"loads model"| node_llm

click node_chatui "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/frontend/app/page.tsx"
click node_chatapi "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/frontend/app/api/chat/route.ts"
click node_ingestapi "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/frontend/app/api/ingest/route.ts"
click node_client "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/frontend/lib/langgraph-base.ts"
click node_ingest "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/ingestion_graph/graph.ts"
click node_ingeststate "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/ingestion_graph/state.ts"
click node_ingestconfig "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/ingestion_graph/configuration.ts"
click node_retrieval "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/retrieval_graph/graph.ts"
click node_retrievalstate "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/retrieval_graph/state.ts"
click node_retrievalconfig "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/retrieval_graph/configuration.ts"
click node_prompts "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/retrieval_graph/prompts.ts"
click node_format "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/retrieval_graph/utils.ts"
click node_sharedconfig "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/shared/configuration.ts"
click node_retriever "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/shared/retrieval.ts"
click node_docstate "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/shared/state.ts"
click node_modelutils "https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/shared/utils.ts"

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_chatui,node_client,node_user toneBlue
class node_chatapi,node_ingestapi,node_vectorstore toneAmber
class node_ingest,node_ingeststate,node_ingestconfig,node_retrieval,node_retrievalstate,node_retrievalconfig,node_prompts,node_format toneMint
class node_sharedconfig,node_retriever,node_docstate,node_modelutils toneRose
class node_llm toneIndigo
```

## Components

### Chat interface

- [Chat and upload UI](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/frontend/app/page.tsx): `frontend/app/page.tsx`
- [LangGraph client](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/frontend/lib/langgraph-base.ts): `frontend/lib/langgraph-base.ts`

### Application endpoints

- [Chat endpoint](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/frontend/app/api/chat/route.ts): `frontend/app/api/chat/route.ts`
- [Ingest endpoint](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/frontend/app/api/ingest/route.ts): `frontend/app/api/ingest/route.ts`

### LangGraph workflows

- [Document ingestion](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/ingestion_graph/graph.ts): `backend/src/ingestion_graph/graph.ts`
- [Ingestion state](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/ingestion_graph/state.ts): `backend/src/ingestion_graph/state.ts`
- [Ingestion configuration](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/ingestion_graph/configuration.ts): `backend/src/ingestion_graph/configuration.ts`
- [Query routing and answers](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/retrieval_graph/graph.ts): `backend/src/retrieval_graph/graph.ts`
- [Query state](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/retrieval_graph/state.ts): `backend/src/retrieval_graph/state.ts`
- [Query configuration](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/retrieval_graph/configuration.ts): `backend/src/retrieval_graph/configuration.ts`
- [Routing and answer prompts](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/retrieval_graph/prompts.ts): `backend/src/retrieval_graph/prompts.ts`
- [Document formatting](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/retrieval_graph/utils.ts): `backend/src/retrieval_graph/utils.ts`

### Models and retrieval

- [Retriever configuration](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/shared/configuration.ts): `backend/src/shared/configuration.ts`
- [Vector retrieval](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/shared/retrieval.ts): `backend/src/shared/retrieval.ts`
- [Document reducer](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/shared/state.ts): `backend/src/shared/state.ts`
- [Chat model loader](https://github.com/mayooear/ai-pdf-chatbot-langchain/blob/main/backend/src/shared/utils.ts): `backend/src/shared/utils.ts`

### Other components

- **User**
- **Supabase vector store**
- **LLM provider**

## Connections

- User → Chat and upload UI: uses
- Chat and upload UI → Ingest endpoint: uploads PDFs
- Chat and upload UI → Chat endpoint: asks questions
- Chat endpoint → LangGraph client: streams answers
- Ingest endpoint → LangGraph client: submits documents
- Ingest endpoint → Document ingestion: invokes graph
- Chat endpoint → Query routing and answers: invokes graph
- Document ingestion → Ingestion state: uses state (evidence: `backend/src/ingestion_graph/graph.ts`)
- Document ingestion → Ingestion configuration: loads configuration (evidence: `backend/src/ingestion_graph/graph.ts`)
- Document ingestion → Document reducer: reduces documents (evidence: `backend/src/ingestion_graph/graph.ts`)
- Document ingestion → Vector retrieval: adds documents (evidence: `backend/src/ingestion_graph/graph.ts`)
- Ingestion state → Document reducer: reduces state (evidence: `backend/src/ingestion_graph/state.ts`)
- Query routing and answers → Query state: uses state (evidence: `backend/src/retrieval_graph/graph.ts`)
- Query routing and answers → Query configuration: loads configuration (evidence: `backend/src/retrieval_graph/graph.ts`)
- Query routing and answers → Vector retrieval: retrieves documents (evidence: `backend/src/retrieval_graph/graph.ts`)
- Query routing and answers → Document formatting: formats context (evidence: `backend/src/retrieval_graph/graph.ts`)
- Query routing and answers → Routing and answer prompts: uses prompts (evidence: `backend/src/retrieval_graph/graph.ts`)
- Query routing and answers → Chat model loader: loads chat model (evidence: `backend/src/retrieval_graph/graph.ts`)
- Query state → Document reducer: reduces documents (evidence: `backend/src/retrieval_graph/state.ts`)
- Ingestion configuration → Retriever configuration: extends configuration (evidence: `backend/src/ingestion_graph/configuration.ts`)
- Query configuration → Retriever configuration: extends configuration (evidence: `backend/src/retrieval_graph/configuration.ts`)
- Vector retrieval → Retriever configuration: validates configuration (evidence: `backend/src/shared/retrieval.ts`)
- Vector retrieval → Supabase vector store: reads and writes embeddings (evidence: `backend/src/shared/retrieval.ts`)
- Vector retrieval → LLM provider: creates embeddings (evidence: `backend/src/shared/retrieval.ts`)
- Chat model loader → LLM provider: loads model
