# filterrr/rikkaminis architecture

> Architecture diagram of the GitHub repository filterrr/rikkaminis, 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/filterrr/rikkaminis
- Repository: https://github.com/filterrr/rikkaminis

## Overview

RikkaMinis is an Android personal AI-agent app: users configure model providers and start conversations, while the app can also use device-side tools such as a Linux shell and browser automation. The graph keeps those capabilities distinct and includes documented backup, memory, skills, and system integrations. Relationship evidence is limited to the README and the supplied source index/excerpts; unsampled implementation links are omitted rather than inferred.

Main entry points: [`src/android/app/src/main/java/com/openminis/app/MinisApp.kt`](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/MinisApp.kt) (Android app), [`src/android/app/src/main/java/com/openminis/app/data/repository/ChatRepository.kt`](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/repository/ChatRepository.kt) (Chat history), [`src/android/app/src/main/java/com/openminis/app/sandbox/offload/ModelExecutionService.kt`](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/sandbox/offload/ModelExecutionService.kt) (Model execution), [`src/android/app/src/main/java/com/openminis/app/data/repository/SkillRepository.kt`](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/repository/SkillRepository.kt) (Skills)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and chat"]
  node_app["Android app<br/>[MinisApp.kt]"]
  node_chat["Chat history<br/>[ChatRepository.kt]"]
  node_agent["Agent service"]
  node_crash["Crash tracking"]
end

subgraph group_models["Models and tools"]
  node_model["Model execution"]
  node_skills["Skills<br/>[SkillRepository.kt]"]
end

subgraph group_device["Device capabilities"]
  node_browser["Browser automation"]
  node_browserpool["Browser tab pool<br/>[BrowserTabPool.kt]"]
  node_sandbox["Linux sandbox<br/>[PRootKernel.kt]"]
  node_rootfs["Root filesystem<br/>[RootfsManager.kt]"]
  node_accessibility["Accessibility service"]
  node_speech["Speech recognition"]
end

subgraph group_state["Data and configuration"]
  node_chatdb[("Chat database<br/>[AppDatabase.kt]")]
  node_providerconfig["Provider settings"]
  node_memory["Persistent memory"]
  node_backup["Backup and sync<br/>[ConfigBackup.kt]"]
end

subgraph group_integrations["External integrations"]
  node_modelapi["Model providers<br/>[ProviderFactory.kt]"]
  node_modelservice{{"AI services"}}
  node_webdav{{"WebDAV server"}}
  node_mcp["MCP integration<br/>[MCPRepository.kt]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"manages conversations"| node_chat
node_chat -->|"reads and writes"| node_chatdb
node_app -->|"initializes"| node_providerconfig
node_providerconfig -->|"supplies provider configuration"| node_model
node_model -->|"creates provider"| node_modelapi
node_modelapi -.->|"requests inference"| node_modelservice
node_user -->|"requests automation"| node_browser
node_browser -->|"uses shared tabs"| node_browserpool
node_user -->|"runs shell commands"| node_sandbox
node_sandbox -->|"uses root filesystem"| node_rootfs
node_user -->|"extends agent"| node_skills
node_skills -->|"supports persistent memory"| node_memory
node_user -->|"exports or restores"| node_backup
node_backup -->|"syncs backups"| node_webdav
node_user -->|"configures servers"| node_mcp
node_user -->|"uses system integration"| node_accessibility
node_user -->|"uses speech tools"| node_speech
node_app -->|"checks safe mode"| node_crash

click node_app "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/MinisApp.kt"
click node_chat "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/repository/ChatRepository.kt"
click node_chatdb "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/db/AppDatabase.kt"
click node_agent "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/service/AgentForegroundService.kt"
click node_providerconfig "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/repository/ProviderRepository.kt"
click node_model "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/sandbox/offload/ModelExecutionService.kt"
click node_modelapi "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/provider/ProviderFactory.kt"
click node_browser "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/browser/BrowserUseManager.kt"
click node_browserpool "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/browser/BrowserTabPool.kt"
click node_sandbox "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/sandbox/PRootKernel.kt"
click node_rootfs "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/sandbox/RootfsManager.kt"
click node_skills "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/repository/SkillRepository.kt"
click node_memory "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/workspace/MemoryRollupEngine.kt"
click node_backup "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/backup/ConfigBackup.kt"
click node_mcp "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/repository/MCPRepository.kt"
click node_accessibility "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/accessibility/MinisAccessibilityService.kt"
click node_speech "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/speech/SpeechRecognitionManager.kt"
click node_crash "https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/crash/CrashFrequencyDetector.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_app,node_chat,node_agent,node_crash,node_user toneBlue
class node_model,node_skills toneAmber
class node_browser,node_browserpool,node_sandbox,node_rootfs,node_accessibility,node_speech toneMint
class node_chatdb,node_providerconfig,node_memory,node_backup toneRose
class node_modelapi,node_modelservice,node_webdav,node_mcp toneIndigo
```

## Components

### App and chat

- [Android app](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/MinisApp.kt): `src/android/app/src/main/java/com/openminis/app/MinisApp.kt`
- [Chat history](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/repository/ChatRepository.kt): `src/android/app/src/main/java/com/openminis/app/data/repository/ChatRepository.kt`
- [Agent service](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/service/AgentForegroundService.kt): `src/android/app/src/main/java/com/openminis/app/service/AgentForegroundService.kt`
- [Crash tracking](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/crash/CrashFrequencyDetector.kt): `src/android/app/src/main/java/com/openminis/app/crash/CrashFrequencyDetector.kt`

### Models and tools

- [Model execution](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/sandbox/offload/ModelExecutionService.kt): `src/android/app/src/main/java/com/openminis/app/sandbox/offload/ModelExecutionService.kt`
- [Skills](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/repository/SkillRepository.kt): `src/android/app/src/main/java/com/openminis/app/data/repository/SkillRepository.kt`

### Device capabilities

- [Browser automation](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/browser/BrowserUseManager.kt): `src/android/app/src/main/java/com/openminis/app/browser/BrowserUseManager.kt`
- [Browser tab pool](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/browser/BrowserTabPool.kt): `src/android/app/src/main/java/com/openminis/app/browser/BrowserTabPool.kt`
- [Linux sandbox](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/sandbox/PRootKernel.kt): `src/android/app/src/main/java/com/openminis/app/sandbox/PRootKernel.kt`
- [Root filesystem](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/sandbox/RootfsManager.kt): `src/android/app/src/main/java/com/openminis/app/sandbox/RootfsManager.kt`
- [Accessibility service](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/accessibility/MinisAccessibilityService.kt): `src/android/app/src/main/java/com/openminis/app/accessibility/MinisAccessibilityService.kt`
- [Speech recognition](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/speech/SpeechRecognitionManager.kt): `src/android/app/src/main/java/com/openminis/app/speech/SpeechRecognitionManager.kt`

### Data and configuration

- [Chat database](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/db/AppDatabase.kt): `src/android/app/src/main/java/com/openminis/app/data/db/AppDatabase.kt`
- [Provider settings](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/repository/ProviderRepository.kt): `src/android/app/src/main/java/com/openminis/app/data/repository/ProviderRepository.kt`
- [Persistent memory](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/workspace/MemoryRollupEngine.kt): `src/android/app/src/main/java/com/openminis/app/workspace/MemoryRollupEngine.kt`
- [Backup and sync](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/backup/ConfigBackup.kt): `src/android/app/src/main/java/com/openminis/app/backup/ConfigBackup.kt`

### External integrations

- [Model providers](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/provider/ProviderFactory.kt): `src/android/app/src/main/java/com/openminis/app/provider/ProviderFactory.kt`
- **AI services**
- **WebDAV server**
- [MCP integration](https://github.com/filterrr/rikkaminis/blob/main/src/android/app/src/main/java/com/openminis/app/data/repository/MCPRepository.kt): `src/android/app/src/main/java/com/openminis/app/data/repository/MCPRepository.kt`

### Other components

- **User**

## Connections

- User → Android app: uses
- Android app → Chat history: manages conversations (evidence: `src/android/app/src/main/java/com/openminis/app/MinisApp.kt`)
- Chat history → Chat database: reads and writes (evidence: `src/android/app/src/main/java/com/openminis/app/data/repository/ChatRepository.kt`)
- Android app → Provider settings: initializes (evidence: `src/android/app/src/main/java/com/openminis/app/MinisApp.kt`)
- Provider settings → Model execution: supplies provider configuration (evidence: `src/android/app/src/main/java/com/openminis/app/sandbox/offload/ModelExecutionService.kt`)
- Model execution → Model providers: creates provider (evidence: `src/android/app/src/main/java/com/openminis/app/sandbox/offload/ModelExecutionService.kt`)
- Model providers → AI services: requests inference
- User → Browser automation: requests automation
- Browser automation → Browser tab pool: uses shared tabs (evidence: `src/android/app/src/main/java/com/openminis/app/browser/BrowserUseManager.kt`)
- User → Linux sandbox: runs shell commands
- Linux sandbox → Root filesystem: uses root filesystem (evidence: `src/android/app/src/main/java/com/openminis/app/sandbox/PRootKernel.kt`)
- User → Skills: extends agent
- Skills → Persistent memory: supports persistent memory
- User → Backup and sync: exports or restores
- Backup and sync → WebDAV server: syncs backups
- User → MCP integration: configures servers
- User → Accessibility service: uses system integration
- User → Speech recognition: uses speech tools
- Android app → Crash tracking: checks safe mode (evidence: `src/android/app/src/main/java/com/openminis/app/service/AgentForegroundService.kt`)
