# premchand-eidiko/llamaindex architecture

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

- Interactive diagram: https://gitdiagram.com/premchand-eidiko/llamaindex
- Repository: https://github.com/premchand-eidiko/llamaindex

## Overview

The repository’s main product is an Enterprise RAG Assistant: users upload documents, which are loaded, parsed, enriched with metadata, and indexed; they then query or chat against that knowledge base and receive answers with sources. Its API also documents hybrid retrieval, streaming, and GraphRAG capabilities. The tree contains a separate, simpler Day-5 backend/frontend and earlier Day-1–4 learning examples; those are not merged into the main runtime flow. Edges reflect shown calls or explicit module references; unsampled subsystems are included where documented, but uncertain wiring is omitted.

Main entry points: [`Day-5/rag_project/backend/app/main.py`](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/main.py) (API application), [`Day-5/rag_project/backend/app/api/query_routes.py`](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/api/query_routes.py) (Query API), [`Day-5/rag_project/backend/app/core/llm.py`](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/core/llm.py) (LLM provider factory), [`Day-5/rag_project/backend/app/indexes/storage.py`](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/indexes/storage.py) (Index persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and sessions"]
  node_main["API application<br/>[main.py]"]
  node_ingestion_api["Upload API"]
  node_query_api["Query API<br/>[query_routes.py]"]
  node_chat_api["Chat API<br/>[chat_routes.py]"]
  node_graph_api["Graph API<br/>[graph_routes.py]"]
  node_admin_api["Admin API<br/>[admin_routes.py]"]
  node_schemas["Request models<br/>[models.py]"]
end

subgraph group_ingestion["Document ingestion"]
  node_pipeline["Ingestion pipeline<br/>[pipeline.py]"]
  node_loaders["Document loaders<br/>[loaders.py]"]
  node_parsers["Document parsers<br/>[parsers.py]"]
  node_metadata["Metadata extraction<br/>[metadata.py]"]
end

subgraph group_retrieval["Retrieval and query"]
  node_retriever["Retriever manager<br/>[retriever.py]"]
  node_filters["Metadata filters<br/>[filters.py]"]
  node_rerank["Result reranker<br/>[rerank.py]"]
  node_hybrid["Hybrid search<br/>[hybrid.py]"]
  node_streaming["Query streaming<br/>[streaming.py]"]
  node_multi_doc["Multi-document query<br/>[multi_doc.py]"]
end

subgraph group_knowledge["Indexes and graph"]
  node_vector[("Vector index<br/>[vector.py]")]
  node_storage[("Index persistence<br/>[storage.py]")]
  node_graph[("Knowledge graph<br/>[knowledge_graph.py]")]
end

subgraph group_services["LLM and configuration"]
  node_llm["LLM provider factory<br/>[llm.py]"]
  node_config["Runtime settings<br/>[config.py]"]
end

subgraph group_project_app["Alternate Day 5 app"]
  node_alt_api["Alternate backend API<br/>[documents.py]"]
  node_alt_ingest["Alternate ingestion<br/>[ingestion.py]"]
  node_alt_rag["Alternate RAG service<br/>[rag.py]"]
  node_alt_chat[("Conversation storage<br/>[chat_history.py]")]
  node_alt_chat_api["Alternate chat API<br/>[chat.py]"]
end

node_user(("User"))
node_groq["Groq service"]
node_openai["OpenAI service"]

node_user -.->|"sends requests"| node_main
node_main -->|"registers"| node_ingestion_api
node_main -->|"registers"| node_query_api
node_main -->|"registers"| node_chat_api
node_main -->|"registers"| node_graph_api
node_main -->|"registers"| node_admin_api
node_ingestion_api -->|"ingests files"| node_pipeline
node_ingestion_api -->|"creates index"| node_vector
node_ingestion_api -->|"saves index"| node_storage
node_pipeline -->|"loads documents"| node_loaders
node_pipeline -->|"parses documents"| node_parsers
node_pipeline -->|"extracts metadata"| node_metadata
node_query_api -->|"loads index"| node_storage
node_query_api -->|"builds filters"| node_filters
node_query_api -->|"creates retriever"| node_retriever
node_query_api -->|"reranks results"| node_rerank
node_query_api -->|"handles hybrid search"| node_hybrid
node_query_api -->|"streams tokens"| node_streaming
node_query_api -->|"gets LLM"| node_llm
node_storage -->|"coordinates storage"| node_vector
node_chat_api -->|"validates requests"| node_schemas
node_chat_api -->|"loads index"| node_storage
node_chat_api -.->|"logs via"| node_llm
node_chat_api -.->|"persists history"| node_alt_chat
node_graph_api -->|"uses graph"| node_graph
node_admin_api -->|"manages index"| node_storage
node_llm -->|"reads settings"| node_config
node_llm -->|"selects provider"| node_groq
node_llm -->|"falls back"| node_openai
node_main -->|"checks index"| node_storage
node_main -->|"initializes"| node_llm
node_alt_api -->|"ingests documents"| node_alt_ingest
node_alt_api -->|"uses RAG service"| node_alt_rag
node_alt_api -->|"manages history"| node_alt_chat
node_alt_chat_api -->|"uses history"| node_alt_chat
node_alt_chat_api -->|"queries RAG"| node_alt_rag

click node_main "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/main.py"
click node_ingestion_api "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/api/ingestion_routes.py"
click node_query_api "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/api/query_routes.py"
click node_chat_api "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/api/chat_routes.py"
click node_graph_api "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/api/graph_routes.py"
click node_admin_api "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/api/admin_routes.py"
click node_schemas "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/schemas/models.py"
click node_pipeline "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/ingestion/pipeline.py"
click node_loaders "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/ingestion/loaders.py"
click node_parsers "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/ingestion/parsers.py"
click node_metadata "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/ingestion/metadata.py"
click node_retriever "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/retrieval/retriever.py"
click node_filters "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/retrieval/filters.py"
click node_rerank "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/retrieval/rerank.py"
click node_hybrid "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/retrieval/hybrid.py"
click node_streaming "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/query/streaming.py"
click node_multi_doc "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/query/multi_doc.py"
click node_vector "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/indexes/vector.py"
click node_storage "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/indexes/storage.py"
click node_graph "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/graph/knowledge_graph.py"
click node_llm "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/core/llm.py"
click node_config "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/core/config.py"
click node_alt_api "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/project/backend/app/api/documents.py"
click node_alt_ingest "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/project/backend/app/services/ingestion.py"
click node_alt_rag "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/project/backend/app/services/rag.py"
click node_alt_chat "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/project/backend/app/services/chat_history.py"
click node_alt_chat_api "https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/project/backend/app/api/chat.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_main,node_ingestion_api,node_query_api,node_chat_api,node_graph_api,node_admin_api,node_schemas,node_user toneBlue
class node_pipeline,node_loaders,node_parsers,node_metadata toneAmber
class node_retriever,node_filters,node_rerank,node_hybrid,node_streaming,node_multi_doc toneMint
class node_vector,node_storage,node_graph toneRose
class node_llm,node_config,node_groq,node_openai toneIndigo
class node_alt_api,node_alt_ingest,node_alt_rag,node_alt_chat,node_alt_chat_api toneTeal
```

## Components

### API and sessions

- [API application](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/main.py): `Day-5/rag_project/backend/app/main.py`
- [Upload API](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/api/ingestion_routes.py): `Day-5/rag_project/backend/app/api/ingestion_routes.py`
- [Query API](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/api/query_routes.py): `Day-5/rag_project/backend/app/api/query_routes.py`
- [Chat API](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/api/chat_routes.py): `Day-5/rag_project/backend/app/api/chat_routes.py`
- [Graph API](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/api/graph_routes.py): `Day-5/rag_project/backend/app/api/graph_routes.py`
- [Admin API](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/api/admin_routes.py): `Day-5/rag_project/backend/app/api/admin_routes.py`
- [Request models](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/schemas/models.py): `Day-5/rag_project/backend/app/schemas/models.py`

### Document ingestion

- [Ingestion pipeline](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/ingestion/pipeline.py): `Day-5/rag_project/backend/app/ingestion/pipeline.py`
- [Document loaders](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/ingestion/loaders.py): `Day-5/rag_project/backend/app/ingestion/loaders.py`
- [Document parsers](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/ingestion/parsers.py): `Day-5/rag_project/backend/app/ingestion/parsers.py`
- [Metadata extraction](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/ingestion/metadata.py): `Day-5/rag_project/backend/app/ingestion/metadata.py`

### Retrieval and query

- [Retriever manager](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/retrieval/retriever.py): `Day-5/rag_project/backend/app/retrieval/retriever.py`
- [Metadata filters](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/retrieval/filters.py): `Day-5/rag_project/backend/app/retrieval/filters.py`
- [Result reranker](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/retrieval/rerank.py): `Day-5/rag_project/backend/app/retrieval/rerank.py`
- [Hybrid search](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/retrieval/hybrid.py): `Day-5/rag_project/backend/app/retrieval/hybrid.py`
- [Query streaming](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/query/streaming.py): `Day-5/rag_project/backend/app/query/streaming.py`
- [Multi-document query](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/query/multi_doc.py): `Day-5/rag_project/backend/app/query/multi_doc.py`

### Indexes and graph

- [Vector index](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/indexes/vector.py): `Day-5/rag_project/backend/app/indexes/vector.py`
- [Index persistence](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/indexes/storage.py): `Day-5/rag_project/backend/app/indexes/storage.py`
- [Knowledge graph](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/graph/knowledge_graph.py): `Day-5/rag_project/backend/app/graph/knowledge_graph.py`

### LLM and configuration

- [LLM provider factory](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/core/llm.py): `Day-5/rag_project/backend/app/core/llm.py`
- [Runtime settings](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/rag_project/backend/app/core/config.py): `Day-5/rag_project/backend/app/core/config.py`

### Alternate Day 5 app

- [Alternate backend API](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/project/backend/app/api/documents.py): `Day-5/project/backend/app/api/documents.py`
- [Alternate ingestion](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/project/backend/app/services/ingestion.py): `Day-5/project/backend/app/services/ingestion.py`
- [Alternate RAG service](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/project/backend/app/services/rag.py): `Day-5/project/backend/app/services/rag.py`
- [Conversation storage](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/project/backend/app/services/chat_history.py): `Day-5/project/backend/app/services/chat_history.py`
- [Alternate chat API](https://github.com/premchand-eidiko/llamaindex/blob/main/Day-5/project/backend/app/api/chat.py): `Day-5/project/backend/app/api/chat.py`

### Other components

- **User**
- **Groq service**
- **OpenAI service**

## Connections

- User → API application: sends requests
- API application → Upload API: registers (evidence: `Day-5/rag_project/backend/app/main.py`)
- API application → Query API: registers (evidence: `Day-5/rag_project/backend/app/main.py`)
- API application → Chat API: registers (evidence: `Day-5/rag_project/backend/app/main.py`)
- API application → Graph API: registers (evidence: `Day-5/rag_project/backend/app/main.py`)
- API application → Admin API: registers (evidence: `Day-5/rag_project/backend/app/main.py`)
- Upload API → Ingestion pipeline: ingests files (evidence: `Day-5/rag_project/backend/app/api/ingestion_routes.py`)
- Upload API → Vector index: creates index (evidence: `Day-5/rag_project/backend/app/api/ingestion_routes.py`)
- Upload API → Index persistence: saves index (evidence: `Day-5/rag_project/backend/app/api/ingestion_routes.py`)
- Ingestion pipeline → Document loaders: loads documents (evidence: `Day-5/rag_project/backend/app/ingestion/pipeline.py`)
- Ingestion pipeline → Document parsers: parses documents (evidence: `Day-5/rag_project/backend/app/ingestion/pipeline.py`)
- Ingestion pipeline → Metadata extraction: extracts metadata (evidence: `Day-5/rag_project/backend/app/ingestion/pipeline.py`)
- Query API → Index persistence: loads index (evidence: `Day-5/rag_project/backend/app/api/query_routes.py`)
- Query API → Metadata filters: builds filters (evidence: `Day-5/rag_project/backend/app/api/query_routes.py`)
- Query API → Retriever manager: creates retriever (evidence: `Day-5/rag_project/backend/app/api/query_routes.py`)
- Query API → Result reranker: reranks results (evidence: `Day-5/rag_project/backend/app/api/query_routes.py`)
- Query API → Hybrid search: handles hybrid search (evidence: `Day-5/rag_project/backend/app/api/query_routes.py`)
- Query API → Query streaming: streams tokens (evidence: `Day-5/rag_project/backend/app/api/query_routes.py`)
- Query API → LLM provider factory: gets LLM (evidence: `Day-5/rag_project/backend/app/api/query_routes.py`)
- Index persistence → Vector index: coordinates storage (evidence: `Day-5/rag_project/backend/app/indexes/storage.py`)
- Chat API → Request models: validates requests (evidence: `Day-5/rag_project/backend/app/api/chat_routes.py`)
- Chat API → Index persistence: loads index (evidence: `Day-5/rag_project/backend/app/api/chat_routes.py`)
- Chat API → LLM provider factory: logs via
- Chat API → Conversation storage: persists history
- Graph API → Knowledge graph: uses graph (evidence: `Day-5/rag_project/backend/app/api/graph_routes.py`)
- Admin API → Index persistence: manages index (evidence: `Day-5/rag_project/backend/app/api/admin_routes.py`)
- LLM provider factory → Runtime settings: reads settings (evidence: `Day-5/rag_project/backend/app/core/llm.py`)
- LLM provider factory → Groq service: selects provider (evidence: `Day-5/rag_project/backend/app/core/llm.py`)
- LLM provider factory → OpenAI service: falls back (evidence: `Day-5/rag_project/backend/app/core/llm.py`)
- API application → Index persistence: checks index (evidence: `Day-5/rag_project/backend/app/main.py`)
- API application → LLM provider factory: initializes (evidence: `Day-5/rag_project/backend/app/main.py`)
- Alternate backend API → Alternate ingestion: ingests documents (evidence: `Day-5/project/backend/app/api/documents.py`)
- Alternate backend API → Alternate RAG service: uses RAG service (evidence: `Day-5/project/backend/app/api/documents.py`)
- Alternate backend API → Conversation storage: manages history (evidence: `Day-5/project/backend/app/api/documents.py`)
- Alternate chat API → Conversation storage: uses history (evidence: `Day-5/project/backend/app/api/chat.py`)
- Alternate chat API → Alternate RAG service: queries RAG (evidence: `Day-5/project/backend/app/api/chat.py`)
