# yunlv-l/rikkahub-armv7a architecture

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

- Interactive diagram: https://gitdiagram.com/yunlv-l/rikkahub-armv7a
- Repository: https://github.com/yunlv-l/rikkahub-armv7a

## Overview

RikkaHub is a native Android LLM chat client. The principal workflow is composing a conversation, generating a response through a selected AI provider, and retaining the conversation; the app also supports tools, search, MCP, multimodal input, workspaces, speech, and web access. The graph reflects the documented capabilities and sampled ChatService/provider wiring. Several feature subsystems are represented from the README and file tree, so their internal connections are left unverified rather than inferred.

Main entry points: [`app/src/main/java/me/rerere/rikkahub/service/ChatService.kt`](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/service/ChatService.kt) (Chat service), [`app/src/main/java/me/rerere/rikkahub/ui/pages/chat/ChatPage.kt`](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/ui/pages/chat/ChatPage.kt) (Chat UI), [`app/src/main/java/me/rerere/rikkahub/data/ai/GenerationHandler.kt`](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/ai/GenerationHandler.kt) (Generation handler), [`ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt`](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt) (Provider manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_conversation["Conversation"]
  node_chatui["Chat UI<br/>[ChatPage.kt]"]
  node_chatservice["Chat service<br/>[ChatService.kt]"]
  node_messages["Message model<br/>[Message.kt]"]
end

subgraph group_ai["AI Runtime"]
  node_generation["Generation handler"]
  node_providers["Provider manager<br/>[ProviderManager.kt]"]
  node_providerapi["Provider adapters<br/>[Provider.kt]"]
  node_streaming["Stream handler"]
end

subgraph group_capabilities["Extensions"]
  node_tools["AI tools"]
  node_mcp["MCP integration<br/>[McpManager.kt]"]
  node_search["Web search<br/>[SearchService.kt]"]
  node_workspace["Workspace"]
  node_documents["Document input<br/>[DocxParser.kt]"]
  node_speech["Speech services<br/>[TtsController.kt]"]
  node_web["Web access"]
end

subgraph group_persistence["App Data"]
  node_conversationrepo["Conversation repository"]
  node_database[("Room database<br/>[AppDatabase.kt]")]
  node_files["File manager<br/>[FilesManager.kt]"]
  node_skills["Skills manager<br/>[SkillManager.kt]"]
end

node_user(("User"))

node_user -.->|"composes"| node_chatui
node_chatui -.->|"requests generation"| node_chatservice
node_chatservice -->|"delegates"| node_generation
node_chatservice -->|"selects provider"| node_providers
node_providers -->|"registers adapters"| node_providerapi
node_generation -.->|"uses messages"| node_messages
node_chatservice -.->|"handles stream"| node_streaming
node_chatservice -.->|"uses tools"| node_tools
node_chatservice -->|"uses MCP"| node_mcp
node_chatservice -->|"loads skills"| node_skills
node_chatservice -.->|"persists conversation"| node_conversationrepo
node_conversationrepo -.->|"reads and writes"| node_database
node_chatservice -->|"copies attachments"| node_files
node_chatservice -.->|"supports search"| node_search
node_chatservice -.->|"supports workspace"| node_workspace
node_chatui -.->|"accepts documents"| node_documents
node_chatui -.->|"supports speech"| node_speech
node_user -.->|"accesses web client"| node_web

click node_chatui "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/ui/pages/chat/ChatPage.kt"
click node_chatservice "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/service/ChatService.kt"
click node_messages "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/ai/src/main/java/me/rerere/ai/ui/Message.kt"
click node_generation "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/ai/GenerationHandler.kt"
click node_providers "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt"
click node_providerapi "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/ai/src/main/java/me/rerere/ai/provider/Provider.kt"
click node_streaming "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/ai/src/main/java/me/rerere/ai/ui/StreamChunkHandler.kt"
click node_tools "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/ai/tools/ConversationTools.kt"
click node_mcp "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/ai/mcp/McpManager.kt"
click node_search "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/search/src/main/java/me/rerere/search/SearchService.kt"
click node_workspace "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/workspace/src/main/java/me/rerere/workspace/WorkspaceManager.kt"
click node_documents "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/document/src/main/java/me/rerere/document/DocxParser.kt"
click node_speech "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/speech/src/main/java/me/rerere/tts/controller/TtsController.kt"
click node_web "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/web/WebServerManager.kt"
click node_conversationrepo "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/repository/ConversationRepository.kt"
click node_database "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/db/AppDatabase.kt"
click node_files "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/files/FilesManager.kt"
click node_skills "https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/files/SkillManager.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_chatui,node_chatservice,node_messages,node_user toneBlue
class node_generation,node_providers,node_providerapi,node_streaming toneAmber
class node_tools,node_mcp,node_search,node_workspace,node_documents,node_speech,node_web toneMint
class node_conversationrepo,node_database,node_files,node_skills toneRose
```

## Components

### Conversation

- [Chat UI](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/ui/pages/chat/ChatPage.kt): `app/src/main/java/me/rerere/rikkahub/ui/pages/chat/ChatPage.kt`
- [Chat service](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/service/ChatService.kt): `app/src/main/java/me/rerere/rikkahub/service/ChatService.kt`
- [Message model](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/ai/src/main/java/me/rerere/ai/ui/Message.kt): `ai/src/main/java/me/rerere/ai/ui/Message.kt`

### AI Runtime

- [Generation handler](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/ai/GenerationHandler.kt): `app/src/main/java/me/rerere/rikkahub/data/ai/GenerationHandler.kt`
- [Provider manager](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt): `ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt`
- [Provider adapters](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/ai/src/main/java/me/rerere/ai/provider/Provider.kt): `ai/src/main/java/me/rerere/ai/provider/Provider.kt`
- [Stream handler](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/ai/src/main/java/me/rerere/ai/ui/StreamChunkHandler.kt): `ai/src/main/java/me/rerere/ai/ui/StreamChunkHandler.kt`

### Extensions

- [AI tools](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/ai/tools/ConversationTools.kt): `app/src/main/java/me/rerere/rikkahub/data/ai/tools/ConversationTools.kt`
- [MCP integration](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/ai/mcp/McpManager.kt): `app/src/main/java/me/rerere/rikkahub/data/ai/mcp/McpManager.kt`
- [Web search](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/search/src/main/java/me/rerere/search/SearchService.kt): `search/src/main/java/me/rerere/search/SearchService.kt`
- [Workspace](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/workspace/src/main/java/me/rerere/workspace/WorkspaceManager.kt): `workspace/src/main/java/me/rerere/workspace/WorkspaceManager.kt`
- [Document input](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/document/src/main/java/me/rerere/document/DocxParser.kt): `document/src/main/java/me/rerere/document/DocxParser.kt`
- [Speech services](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/speech/src/main/java/me/rerere/tts/controller/TtsController.kt): `speech/src/main/java/me/rerere/tts/controller/TtsController.kt`
- [Web access](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/web/WebServerManager.kt): `app/src/main/java/me/rerere/rikkahub/web/WebServerManager.kt`

### App Data

- [Conversation repository](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/repository/ConversationRepository.kt): `app/src/main/java/me/rerere/rikkahub/data/repository/ConversationRepository.kt`
- [Room database](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/db/AppDatabase.kt): `app/src/main/java/me/rerere/rikkahub/data/db/AppDatabase.kt`
- [File manager](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/files/FilesManager.kt): `app/src/main/java/me/rerere/rikkahub/data/files/FilesManager.kt`
- [Skills manager](https://github.com/yunlv-l/rikkahub-armv7a/blob/master/app/src/main/java/me/rerere/rikkahub/data/files/SkillManager.kt): `app/src/main/java/me/rerere/rikkahub/data/files/SkillManager.kt`

### Other components

- **User**

## Connections

- User → Chat UI: composes (evidence: `README.md`)
- Chat UI → Chat service: requests generation
- Chat service → Generation handler: delegates (evidence: `app/src/main/java/me/rerere/rikkahub/service/ChatService.kt`)
- Chat service → Provider manager: selects provider (evidence: `app/src/main/java/me/rerere/rikkahub/service/ChatService.kt`)
- Provider manager → Provider adapters: registers adapters (evidence: `ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt`)
- Generation handler → Message model: uses messages
- Chat service → Stream handler: handles stream
- Chat service → AI tools: uses tools
- Chat service → MCP integration: uses MCP (evidence: `app/src/main/java/me/rerere/rikkahub/service/ChatService.kt`)
- Chat service → Skills manager: loads skills (evidence: `app/src/main/java/me/rerere/rikkahub/service/ChatService.kt`)
- Chat service → Conversation repository: persists conversation (evidence: `app/src/main/java/me/rerere/rikkahub/service/ChatService.kt`)
- Conversation repository → Room database: reads and writes (evidence: `app/src/main/java/me/rerere/rikkahub/data/repository/ConversationRepository.kt`)
- Chat service → File manager: copies attachments (evidence: `app/src/main/java/me/rerere/rikkahub/service/ChatService.kt`)
- Chat service → Web search: supports search (evidence: `README.md`)
- Chat service → Workspace: supports workspace (evidence: `README.md`)
- Chat UI → Document input: accepts documents (evidence: `README.md`)
- Chat UI → Speech services: supports speech (evidence: `README.md`)
- User → Web access: accesses web client (evidence: `README.md`)
