# harshalbisen-hb/android-ondevice-rag---the-rag-bot architecture

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

- Interactive diagram: https://gitdiagram.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot
- Repository: https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot

## Overview

The RAG Bot is an Android app for chatting with answers grounded in user documents. Users add documents, which the app reads, splits into chunks, and indexes as embeddings; chat queries retrieve relevant passages and stream a response from a local LiteRT model or optional Gemini service. Chat sessions persist locally. The app also provides document and credential screens, configurable chunking, and local model import/download management. Relationships for unsampled features are included only where the README documents them; source excerpts do not show every ingestion or downloader call.

Main entry points: [`app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt`](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt) (Chat orchestration), [`app/src/main/java/com/ml/hrb/h/ui/screens/docs/DocsViewModel.kt`](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/docs/DocsViewModel.kt) (Document management), [`app/src/main/java/com/ml/hrb/h/MainActivity.kt`](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/MainActivity.kt) (Navigation host), [`app/src/main/java/com/ml/hrb/h/ui/screens/local_models/LocalModelsViewModel.kt`](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/local_models/LocalModelsViewModel.kt) (Model manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["App and screens"]
  node_activity["Navigation host<br/>[MainActivity.kt]"]
  node_chatui["Chat screen<br/>[ChatScreen.kt]"]
  node_chatvm["Chat orchestration<br/>[ChatViewModel.kt]"]
  node_docsui["Documents screen<br/>[DocsScreen.kt]"]
  node_docsvm["Document management<br/>[DocsViewModel.kt]"]
  node_credentials["Credential settings"]
end

subgraph group_rag["Document retrieval"]
  node_chunksettings["Chunking settings"]
  node_readers["Document readers<br/>[Readers.kt]"]
  node_splitter["Text splitting"]
  node_embeddingprovider["Embedding provider"]
  node_embedding["ONNX embeddings"]
end

subgraph group_inference["Models and generation"]
  node_localmodels["Model manager"]
  node_litert["Local LiteRT<br/>[LiteRTAPI.kt]"]
  node_llminterface["Inference interface<br/>[LLMInferenceAPI.kt]"]
  node_gemini["Gemini streaming<br/>[GeminiRemoteAPI.kt]"]
end

subgraph group_storage["Local data"]
  node_chunksdb[("Chunk index<br/>[ChunksDB.kt]")]
  node_documentsdb[("Document records<br/>[DocumentsDB.kt]")]
  node_objectbox[("ObjectBox store<br/>[ObjectBoxStore.kt]")]
  node_history[("Chat history<br/>[ChatHistoryDB.kt]")]
end

node_user(("User"))
node_geminiservice{{"Gemini service"}}
node_huggingface{{"Model host"}}

node_user -->|"opens app"| node_activity
node_activity -->|"routes to"| node_chatui
node_activity -->|"routes to"| node_docsui
node_activity -->|"routes to"| node_credentials
node_activity -->|"routes to"| node_localmodels
node_chatui -->|"sends events"| node_chatvm
node_chatvm -->|"retrieves chunks"| node_chunksdb
node_chatvm -->|"checks documents"| node_documentsdb
node_chatvm -->|"encodes query"| node_embeddingprovider
node_chatvm -->|"loads and saves"| node_history
node_chatvm -->|"streams locally"| node_litert
node_chatvm -.->|"streams remotely"| node_gemini
node_litert -->|"implements"| node_llminterface
node_gemini -->|"implements"| node_llminterface
node_gemini -.->|"requests generation"| node_geminiservice
node_docsui -->|"sends events"| node_docsvm
node_docsvm -.->|"reads documents"| node_readers
node_docsvm -.->|"splits text"| node_splitter
node_chunksettings -.->|"configures splitting"| node_splitter
node_docsvm -.->|"embeds chunks"| node_embeddingprovider
node_embeddingprovider -->|"encodes text"| node_embedding
node_docsvm -.->|"indexes chunks"| node_chunksdb
node_docsvm -.->|"stores records"| node_documentsdb
node_history -->|"uses store"| node_objectbox
node_chunksdb -->|"uses store"| node_objectbox
node_documentsdb -->|"uses store"| node_objectbox
node_localmodels -->|"loads models"| node_litert
node_localmodels -.->|"downloads models"| node_huggingface

click node_activity "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/MainActivity.kt"
click node_chatui "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatScreen.kt"
click node_chatvm "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt"
click node_docsui "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/docs/DocsScreen.kt"
click node_docsvm "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/docs/DocsViewModel.kt"
click node_credentials "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/edit_credentials/EditCredentialsScreen.kt"
click node_chunksettings "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/data/ChunkingSettings.kt"
click node_readers "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/readers/Readers.kt"
click node_splitter "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/WhiteSpaceSplitter.kt"
click node_embeddingprovider "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/SentenceEmbeddingProvider.kt"
click node_embedding "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/SentenceEmbedding.kt"
click node_chunksdb "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/data/ChunksDB.kt"
click node_documentsdb "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/data/DocumentsDB.kt"
click node_objectbox "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/data/ObjectBoxStore.kt"
click node_history "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/data/ChatHistoryDB.kt"
click node_localmodels "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/local_models/LocalModelsViewModel.kt"
click node_litert "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/llm/LiteRTAPI.kt"
click node_llminterface "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/llm/LLMInferenceAPI.kt"
click node_gemini "https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/llm/GeminiRemoteAPI.kt"

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_activity,node_chatui,node_chatvm,node_docsui,node_docsvm,node_credentials,node_user toneBlue
class node_chunksettings,node_readers,node_splitter,node_embeddingprovider,node_embedding toneAmber
class node_localmodels,node_litert,node_llminterface,node_gemini toneMint
class node_chunksdb,node_documentsdb,node_objectbox,node_history toneRose
class node_geminiservice,node_huggingface toneIndigo
```

## Components

### App and screens

- [Navigation host](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/MainActivity.kt): `app/src/main/java/com/ml/hrb/h/MainActivity.kt`
- [Chat screen](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatScreen.kt): `app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatScreen.kt`
- [Chat orchestration](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt): `app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt`
- [Documents screen](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/docs/DocsScreen.kt): `app/src/main/java/com/ml/hrb/h/ui/screens/docs/DocsScreen.kt`
- [Document management](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/docs/DocsViewModel.kt): `app/src/main/java/com/ml/hrb/h/ui/screens/docs/DocsViewModel.kt`
- [Credential settings](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/edit_credentials/EditCredentialsScreen.kt): `app/src/main/java/com/ml/hrb/h/ui/screens/edit_credentials/EditCredentialsScreen.kt`

### Document retrieval

- [Chunking settings](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/data/ChunkingSettings.kt): `app/src/main/java/com/ml/hrb/h/data/ChunkingSettings.kt`
- [Document readers](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/readers/Readers.kt): `app/src/main/java/com/ml/hrb/h/domain/readers/Readers.kt`
- [Text splitting](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/WhiteSpaceSplitter.kt): `app/src/main/java/com/ml/hrb/h/domain/WhiteSpaceSplitter.kt`
- [Embedding provider](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/SentenceEmbeddingProvider.kt): `app/src/main/java/com/ml/hrb/h/domain/SentenceEmbeddingProvider.kt`
- [ONNX embeddings](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/SentenceEmbedding.kt): `app/src/main/java/com/ml/hrb/h/domain/SentenceEmbedding.kt`

### Models and generation

- [Model manager](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/ui/screens/local_models/LocalModelsViewModel.kt): `app/src/main/java/com/ml/hrb/h/ui/screens/local_models/LocalModelsViewModel.kt`
- [Local LiteRT](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/llm/LiteRTAPI.kt): `app/src/main/java/com/ml/hrb/h/domain/llm/LiteRTAPI.kt`
- [Inference interface](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/llm/LLMInferenceAPI.kt): `app/src/main/java/com/ml/hrb/h/domain/llm/LLMInferenceAPI.kt`
- [Gemini streaming](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/domain/llm/GeminiRemoteAPI.kt): `app/src/main/java/com/ml/hrb/h/domain/llm/GeminiRemoteAPI.kt`

### Local data

- [Chunk index](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/data/ChunksDB.kt): `app/src/main/java/com/ml/hrb/h/data/ChunksDB.kt`
- [Document records](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/data/DocumentsDB.kt): `app/src/main/java/com/ml/hrb/h/data/DocumentsDB.kt`
- [ObjectBox store](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/data/ObjectBoxStore.kt): `app/src/main/java/com/ml/hrb/h/data/ObjectBoxStore.kt`
- [Chat history](https://github.com/harshalbisen-hb/android-ondevice-rag---the-rag-bot/blob/main/app/src/main/java/com/ml/hrb/h/data/ChatHistoryDB.kt): `app/src/main/java/com/ml/hrb/h/data/ChatHistoryDB.kt`

### Other components

- **User**
- **Gemini service**
- **Model host**

## Connections

- User → Navigation host: opens app (evidence: `app/src/main/java/com/ml/hrb/h/MainActivity.kt`)
- Navigation host → Chat screen: routes to (evidence: `app/src/main/java/com/ml/hrb/h/MainActivity.kt`)
- Navigation host → Documents screen: routes to (evidence: `app/src/main/java/com/ml/hrb/h/MainActivity.kt`)
- Navigation host → Credential settings: routes to (evidence: `app/src/main/java/com/ml/hrb/h/MainActivity.kt`)
- Navigation host → Model manager: routes to (evidence: `app/src/main/java/com/ml/hrb/h/MainActivity.kt`)
- Chat screen → Chat orchestration: sends events (evidence: `app/src/main/java/com/ml/hrb/h/MainActivity.kt`)
- Chat orchestration → Chunk index: retrieves chunks (evidence: `app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt`)
- Chat orchestration → Document records: checks documents (evidence: `app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt`)
- Chat orchestration → Embedding provider: encodes query (evidence: `app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt`)
- Chat orchestration → Chat history: loads and saves (evidence: `app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt`)
- Chat orchestration → Local LiteRT: streams locally (evidence: `app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt`)
- Chat orchestration → Gemini streaming: streams remotely (evidence: `app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt`)
- Local LiteRT → Inference interface: implements (evidence: `app/src/main/java/com/ml/hrb/h/domain/llm/LiteRTAPI.kt`)
- Gemini streaming → Inference interface: implements (evidence: `app/src/main/java/com/ml/hrb/h/domain/llm/GeminiRemoteAPI.kt`)
- Gemini streaming → Gemini service: requests generation (evidence: `README.md`)
- Documents screen → Document management: sends events (evidence: `app/src/main/java/com/ml/hrb/h/MainActivity.kt`)
- Document management → Document readers: reads documents (evidence: `README.md`)
- Document management → Text splitting: splits text (evidence: `README.md`)
- Chunking settings → Text splitting: configures splitting (evidence: `README.md`)
- Document management → Embedding provider: embeds chunks (evidence: `README.md`)
- Embedding provider → ONNX embeddings: encodes text (evidence: `app/src/main/java/com/ml/hrb/h/domain/SentenceEmbeddingProvider.kt`)
- Document management → Chunk index: indexes chunks (evidence: `README.md`)
- Document management → Document records: stores records (evidence: `README.md`)
- Chat history → ObjectBox store: uses store (evidence: `app/src/main/java/com/ml/hrb/h/data/ChatHistoryDB.kt`)
- Chunk index → ObjectBox store: uses store (evidence: `app/src/main/java/com/ml/hrb/h/data/ChunksDB.kt`)
- Document records → ObjectBox store: uses store (evidence: `app/src/main/java/com/ml/hrb/h/data/DocumentsDB.kt`)
- Model manager → Local LiteRT: loads models (evidence: `app/src/main/java/com/ml/hrb/h/ui/screens/local_models/LocalModelsViewModel.kt`)
- Model manager → Model host: downloads models (evidence: `README.md`)
