How harshalbisen-hb/android-ondevice-rag---the-rag-bot works
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: ChatViewModel.kt Chat orchestration · DocsViewModel.kt Document management · MainActivity.kt Navigation host · LocalModelsViewModel.kt Model manager
Components 22
App and screens
- Navigation host
app/src/main/java/com/ml/hrb/h/MainActivity.kt - Chat screen
app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatScreen.kt - Chat orchestration
app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt - Documents screen
app/src/main/java/com/ml/hrb/h/ui/screens/docs/DocsScreen.kt - Document management
app/src/main/java/com/ml/hrb/h/ui/screens/docs/DocsViewModel.kt - Credential settings
app/src/main/java/com/ml/hrb/h/ui/screens/edit_credentials/EditCredentialsScreen.kt
Document retrieval
- Chunking settings
app/src/main/java/com/ml/hrb/h/data/ChunkingSettings.kt - Document readers
app/src/main/java/com/ml/hrb/h/domain/readers/Readers.kt - Text splitting
app/src/main/java/com/ml/hrb/h/domain/WhiteSpaceSplitter.kt - Embedding provider
app/src/main/java/com/ml/hrb/h/domain/SentenceEmbeddingProvider.kt - ONNX embeddings
app/src/main/java/com/ml/hrb/h/domain/SentenceEmbedding.kt
Models and generation
- Model manager
app/src/main/java/com/ml/hrb/h/ui/screens/local_models/LocalModelsViewModel.kt - Local LiteRT
app/src/main/java/com/ml/hrb/h/domain/llm/LiteRTAPI.kt - Inference interface
app/src/main/java/com/ml/hrb/h/domain/llm/LLMInferenceAPI.kt - Gemini streaming
app/src/main/java/com/ml/hrb/h/domain/llm/GeminiRemoteAPI.kt
Local data
- Chunk index
app/src/main/java/com/ml/hrb/h/data/ChunksDB.kt - Document records
app/src/main/java/com/ml/hrb/h/data/DocumentsDB.kt - ObjectBox store
app/src/main/java/com/ml/hrb/h/data/ObjectBoxStore.kt - Chat history
app/src/main/java/com/ml/hrb/h/data/ChatHistoryDB.kt
Other components
- User
- Gemini service
- Model host
Connections 28
- User → Navigation host: opens app
app/src/main/java/com/ml/hrb/h/MainActivity.kt - Navigation host → Chat screen: routes to
app/src/main/java/com/ml/hrb/h/MainActivity.kt - Navigation host → Documents screen: routes to
app/src/main/java/com/ml/hrb/h/MainActivity.kt - Navigation host → Credential settings: routes to
app/src/main/java/com/ml/hrb/h/MainActivity.kt - Navigation host → Model manager: routes to
app/src/main/java/com/ml/hrb/h/MainActivity.kt - Chat screen → Chat orchestration: sends events
app/src/main/java/com/ml/hrb/h/MainActivity.kt - Chat orchestration → Chunk index: retrieves chunks
app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt - Chat orchestration → Document records: checks documents
app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt - Chat orchestration → Embedding provider: encodes query
app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt - Chat orchestration → Chat history: loads and saves
app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt - Chat orchestration → Local LiteRT: streams locally
app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt - Chat orchestration → Gemini streaming: streams remotely
app/src/main/java/com/ml/hrb/h/ui/screens/chat/ChatViewModel.kt - Local LiteRT → Inference interface: implements
app/src/main/java/com/ml/hrb/h/domain/llm/LiteRTAPI.kt - Gemini streaming → Inference interface: implements
app/src/main/java/com/ml/hrb/h/domain/llm/GeminiRemoteAPI.kt - Gemini streaming → Gemini service: requests generation
README.md - Documents screen → Document management: sends events
app/src/main/java/com/ml/hrb/h/MainActivity.kt - Document management → Document readers: reads documents
README.md - Document management → Text splitting: splits text
README.md - Chunking settings → Text splitting: configures splitting
README.md - Document management → Embedding provider: embeds chunks
README.md - Embedding provider → ONNX embeddings: encodes text
app/src/main/java/com/ml/hrb/h/domain/SentenceEmbeddingProvider.kt - Document management → Chunk index: indexes chunks
README.md - Document management → Document records: stores records
README.md - Chat history → ObjectBox store: uses store
app/src/main/java/com/ml/hrb/h/data/ChatHistoryDB.kt - Chunk index → ObjectBox store: uses store
app/src/main/java/com/ml/hrb/h/data/ChunksDB.kt - Document records → ObjectBox store: uses store
app/src/main/java/com/ml/hrb/h/data/DocumentsDB.kt - Model manager → Local LiteRT: loads models
app/src/main/java/com/ml/hrb/h/ui/screens/local_models/LocalModelsViewModel.kt - Model manager → Model host: downloads models
README.md