# mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag architecture

> Architecture diagram of the GitHub repository mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag
- Repository: https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag

## Overview

TrustRAG is an evidence-first, multi-agent RAG platform. The principal workflow is a user uploading tenant-scoped documents, asking a scoped question, and receiving a cited consensus answer with trust and evaluation metrics. The graph follows the documented client → Express backend → FastAPI AI service flow, then shows ingestion, retrieval, agent review, consensus, and persisted results. The README documents several capabilities whose implementation details were not sampled; those links are shown only where documented.

Main entry points: [`ai-service/app/api/rag.py`](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/api/rag.py) (RAG API), [`backend/src/server.ts`](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/server.ts) (API server), [`src/lib/api-client.ts`](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/src/lib/api-client.ts) (API client), [`backend/src/models`](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/tree/main/backend/src/models) (Application records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User application"]
  node_app_ui["App screens<br/>[app.chat.tsx]"]
  node_upload_ui["Knowledge screens<br/>[app.knowledge.tsx]"]
  node_api_client["API client<br/>[api-client.ts]"]
  node_doc_store["Document store<br/>[doc-store.ts]"]
  node_eval_ui["Evaluation matrix"]
end

subgraph group_backend["API and security"]
  node_api_server["API server<br/>[server.ts]"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_chat_controller["Chat workflow<br/>[chat.controller.ts]"]
  node_document_controller["Document workflow"]
  node_evidence_controller["Evidence reporting"]
  node_ai_client["AI service client<br/>[ai.service.ts]"]
  node_file_storage["File storage<br/>[storage.service.ts]"]
end

subgraph group_ai["RAG and consensus"]
  node_vector_store[("Vector store<br/>[vectorstore.py]")]
  node_rag_api["RAG API<br/>[rag.py]"]
  node_chunking["Document chunking<br/>[chunker.py]"]
  node_embeddings["Embeddings<br/>[embeddings.py]"]
  node_researcher["Researcher<br/>[researcher.py]"]
  node_fact_checker["Fact checker<br/>[fact_checker.py]"]
  node_critic["Critic<br/>[critic.py]"]
  node_trust_assessor["Trust assessor<br/>[trust_assessor.py]"]
  node_consensus["Consensus engine<br/>[engine.py]"]
  node_reasoner["Final reasoner<br/>[reasoner.py]"]
  node_llm_router["LLM provider routing<br/>[llm_router.py]"]
end

subgraph group_storage["Persistence"]
  node_mongo_models[("Application records")]
end

node_user(("User"))
node_llm_providers{{"Gemini / OpenRouter"}}
node_object_store[("Backblaze B2")]
node_mongodb[("MongoDB")]

node_user -->|"asks / reviews"| node_app_ui
node_user -->|"uploads files"| node_upload_ui
node_app_ui -->|"requests"| node_api_client
node_upload_ui -->|"ingests file"| node_doc_store
node_doc_store -->|"uploads through"| node_api_client
node_api_client -->|"REST requests"| node_api_server
node_api_server -->|"mounts protected routes"| node_auth
node_api_server -->|"routes chat"| node_chat_controller
node_api_server -->|"routes documents"| node_document_controller
node_api_server -->|"routes evidence"| node_evidence_controller
node_chat_controller -->|"runs query pipeline"| node_ai_client
node_chat_controller -->|"persists conversations and results"| node_mongo_models
node_document_controller -->|"persists document records"| node_mongo_models
node_document_controller -->|"stores uploaded files"| node_file_storage
node_file_storage -->|"uploads / deletes objects"| node_object_store
node_mongo_models -->|"stores records"| node_mongodb
node_ai_client -->|"internal HTTP RPC"| node_rag_api
node_rag_api -->|"chunks documents"| node_chunking
node_rag_api -->|"creates embeddings"| node_embeddings
node_rag_api -->|"reads / writes vectors"| node_vector_store
node_rag_api -->|"retrieves evidence"| node_researcher
node_rag_api -->|"cross-checks claims"| node_fact_checker
node_rag_api -->|"audits reasoning"| node_critic
node_rag_api -->|"scores attribution"| node_trust_assessor
node_rag_api -->|"builds consensus"| node_consensus
node_rag_api -->|"requests synthesis"| node_reasoner
node_consensus -->|"feeds final reasoning"| node_reasoner
node_researcher -->|"generates with"| node_llm_router
node_llm_router -->|"calls configured provider"| node_llm_providers
node_eval_ui -->|"loads evaluations"| node_api_client
node_evidence_controller -->|"reads audit results"| node_mongo_models

click node_app_ui "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/src/routes/app.chat.tsx"
click node_upload_ui "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/src/routes/app.knowledge.tsx"
click node_api_client "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/src/lib/api-client.ts"
click node_doc_store "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/src/lib/doc-store.ts"
click node_eval_ui "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/src/components/app/EvaluationMatrixModal.tsx"
click node_api_server "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/server.ts"
click node_auth "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/middleware/auth.ts"
click node_chat_controller "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/controllers/chat.controller.ts"
click node_document_controller "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/controllers/document.controller.ts"
click node_evidence_controller "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/controllers/evidence.controller.ts"
click node_ai_client "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/services/ai.service.ts"
click node_file_storage "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/services/storage.service.ts"
click node_mongo_models "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/tree/main/backend/src/models"
click node_vector_store "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/rag/vectorstore.py"
click node_rag_api "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/api/rag.py"
click node_chunking "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/rag/chunker.py"
click node_embeddings "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/rag/embeddings.py"
click node_researcher "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/agents/researcher.py"
click node_fact_checker "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/agents/fact_checker.py"
click node_critic "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/agents/critic.py"
click node_trust_assessor "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/agents/trust_assessor.py"
click node_consensus "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/consensus/engine.py"
click node_reasoner "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/agents/reasoner.py"
click node_llm_router "https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/core/llm_router.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_app_ui,node_upload_ui,node_api_client,node_doc_store,node_eval_ui,node_user toneBlue
class node_api_server,node_auth,node_chat_controller,node_document_controller,node_evidence_controller,node_ai_client,node_file_storage,node_object_store,node_mongodb toneAmber
class node_vector_store,node_rag_api,node_chunking,node_embeddings,node_researcher,node_fact_checker,node_critic,node_trust_assessor,node_consensus,node_reasoner,node_llm_router,node_llm_providers toneMint
class node_mongo_models toneRose
```

## Components

### User application

- [App screens](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/src/routes/app.chat.tsx): `src/routes/app.chat.tsx`
- [Knowledge screens](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/src/routes/app.knowledge.tsx): `src/routes/app.knowledge.tsx`
- [API client](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/src/lib/api-client.ts): `src/lib/api-client.ts`
- [Document store](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/src/lib/doc-store.ts): `src/lib/doc-store.ts`
- [Evaluation matrix](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/src/components/app/EvaluationMatrixModal.tsx): `src/components/app/EvaluationMatrixModal.tsx`

### API and security

- [API server](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [Authentication](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/middleware/auth.ts): `backend/src/middleware/auth.ts`
- [Chat workflow](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/controllers/chat.controller.ts): `backend/src/controllers/chat.controller.ts`
- [Document workflow](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/controllers/document.controller.ts): `backend/src/controllers/document.controller.ts`
- [Evidence reporting](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/controllers/evidence.controller.ts): `backend/src/controllers/evidence.controller.ts`
- [AI service client](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/services/ai.service.ts): `backend/src/services/ai.service.ts`
- [File storage](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/backend/src/services/storage.service.ts): `backend/src/services/storage.service.ts`

### RAG and consensus

- [Vector store](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/rag/vectorstore.py): `ai-service/app/rag/vectorstore.py`
- [RAG API](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/api/rag.py): `ai-service/app/api/rag.py`
- [Document chunking](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/rag/chunker.py): `ai-service/app/rag/chunker.py`
- [Embeddings](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/rag/embeddings.py): `ai-service/app/rag/embeddings.py`
- [Researcher](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/agents/researcher.py): `ai-service/app/agents/researcher.py`
- [Fact checker](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/agents/fact_checker.py): `ai-service/app/agents/fact_checker.py`
- [Critic](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/agents/critic.py): `ai-service/app/agents/critic.py`
- [Trust assessor](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/agents/trust_assessor.py): `ai-service/app/agents/trust_assessor.py`
- [Consensus engine](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/consensus/engine.py): `ai-service/app/consensus/engine.py`
- [Final reasoner](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/agents/reasoner.py): `ai-service/app/agents/reasoner.py`
- [LLM provider routing](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/blob/main/ai-service/app/core/llm_router.py): `ai-service/app/core/llm_router.py`

### Persistence

- [Application records](https://github.com/mudavath-kumar/major-project-trust-aware-consensus-framework-for-multi-agent-rag/tree/main/backend/src/models): `backend/src/models`

### Other components

- **User**
- **Gemini / OpenRouter**
- **Backblaze B2**
- **MongoDB**

## Connections

- User → App screens: asks / reviews
- User → Knowledge screens: uploads files
- App screens → API client: requests (evidence: `src/routes/app.chat.tsx`)
- Knowledge screens → Document store: ingests file (evidence: `src/routes/app.knowledge.tsx`)
- Document store → API client: uploads through (evidence: `src/lib/doc-store.ts`)
- API client → API server: REST requests
- API server → Authentication: mounts protected routes (evidence: `backend/src/server.ts`)
- API server → Chat workflow: routes chat (evidence: `backend/src/server.ts`)
- API server → Document workflow: routes documents (evidence: `backend/src/server.ts`)
- API server → Evidence reporting: routes evidence (evidence: `backend/src/server.ts`)
- Chat workflow → AI service client: runs query pipeline (evidence: `backend/src/controllers/chat.controller.ts`)
- Chat workflow → Application records: persists conversations and results (evidence: `backend/src/controllers/chat.controller.ts`)
- Document workflow → Application records: persists document records (evidence: `backend/src/controllers/document.controller.ts`)
- Document workflow → File storage: stores uploaded files (evidence: `backend/src/controllers/document.controller.ts`)
- File storage → Backblaze B2: uploads / deletes objects (evidence: `backend/src/services/storage.service.ts`)
- Application records → MongoDB: stores records
- AI service client → RAG API: internal HTTP RPC
- RAG API → Document chunking: chunks documents (evidence: `ai-service/app/api/rag.py`)
- RAG API → Embeddings: creates embeddings (evidence: `ai-service/app/api/rag.py`)
- RAG API → Vector store: reads / writes vectors (evidence: `ai-service/app/api/rag.py`)
- RAG API → Researcher: retrieves evidence (evidence: `ai-service/app/api/rag.py`)
- RAG API → Fact checker: cross-checks claims (evidence: `ai-service/app/api/rag.py`)
- RAG API → Critic: audits reasoning (evidence: `ai-service/app/api/rag.py`)
- RAG API → Trust assessor: scores attribution (evidence: `ai-service/app/api/rag.py`)
- RAG API → Consensus engine: builds consensus (evidence: `ai-service/app/api/rag.py`)
- RAG API → Final reasoner: requests synthesis (evidence: `ai-service/app/api/rag.py`)
- Consensus engine → Final reasoner: feeds final reasoning
- Researcher → LLM provider routing: generates with (evidence: `ai-service/app/agents/researcher.py`)
- LLM provider routing → Gemini / OpenRouter: calls configured provider (evidence: `ai-service/app/core/llm_router.py`)
- Evaluation matrix → API client: loads evaluations
- Evidence reporting → Application records: reads audit results (evidence: `backend/src/controllers/evidence.controller.ts`)
