# ayuilos/miffan architecture

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

- Interactive diagram: https://gitdiagram.com/ayuilos/miffan
- Repository: https://github.com/ayuilos/miffan

## Overview

Miffan is a native Android AI workspace. A user configures an assistant and provider, sends a chat message, and receives a streamed, tool-aware response; tools can involve search, device capabilities, or local/remote workspace files and commands. Conversations and workspace metadata are persisted, while the README also documents translation, document extraction, and browser access. Edges cite README-documented behavior or indexed source references; several UI and storage connections are documented rather than verified from excerpts.

Main entry points: [`app/src/main/java/me/ayuilos/miffan/service/ChatService.kt`](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/service/ChatService.kt) (Chat orchestration), [`app/src/main/java/me/ayuilos/miffan/data/repository/WorkspaceRepository.kt`](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/repository/WorkspaceRepository.kt) (Workspace management), [`app/src/main/java/me/ayuilos/miffan/ui/components/ai/ChatInput.kt`](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/ui/components/ai/ChatInput.kt) (Chat interface), [`ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt`](https://github.com/ayuilos/miffan/blob/master/ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt) (Provider dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Assistant experience"]
  node_chatui["Chat interface<br/>[ChatInput.kt]"]
  node_messageui["Message display<br/>[ChatMessage.kt]"]
  node_assistant["Assistant settings<br/>[Assistant.kt]"]
end

subgraph group_ai["AI runtime"]
  node_chatservice["Chat orchestration<br/>[ChatService.kt]"]
  node_generation["Generation handling"]
  node_provider["Provider dispatch<br/>[ProviderManager.kt]"]
  node_models["Provider services"]
  node_toolcontract["Tool contracts<br/>[Tool.kt]"]
  node_transformers["Prompt transformers"]
end

subgraph group_workspace["Workspaces and tools"]
  node_workspaceui["Workspace interface"]
  node_workspacerepo["Workspace management"]
  node_workspaceengine["Local workspace engine"]
  node_remote["SSH workspaces"]
end

subgraph group_data["Local data"]
  node_conversation["Conversation history"]
  node_database[("App database<br/>[AppDatabase.kt]")]
end

subgraph group_integrations["External capabilities"]
  node_search["Web search<br/>[SearchService.kt]"]
  node_localtools["Device tools<br/>[LocalTools.kt]"]
  node_documents["Document extraction<br/>[DocxParser.kt]"]
  node_translation["Text translation"]
  node_browser["Browser access"]
end

node_user(("Android user"))
node_modelservice{{"Model APIs"}}
node_webservices{{"Search services"}}

node_user -->|"sends message"| node_chatui
node_chatui -.->|"submits chat"| node_chatservice
node_assistant -.->|"configures assistant"| node_chatservice
node_chatservice -->|"delegates generation"| node_generation
node_chatservice -->|"selects provider"| node_provider
node_provider -->|"dispatches requests"| node_models
node_models -.->|"sends requests"| node_modelservice
node_chatservice -->|"uses tools"| node_toolcontract
node_chatservice -->|"transforms messages"| node_transformers
node_chatservice -.->|"manages history"| node_conversation
node_conversation -.->|"persists messages"| node_database
node_chatservice -.->|"streams response"| node_messageui
node_chatservice -.->|"invokes search"| node_search
node_search -.->|"queries providers"| node_webservices
node_chatservice -.->|"invokes device tools"| node_localtools
node_user -->|"chooses workspace"| node_workspaceui
node_workspaceui -.->|"manages workspace"| node_workspacerepo
node_workspacerepo -.->|"uses local engine"| node_workspaceengine
node_workspacerepo -.->|"manages SSH"| node_remote
node_chatservice -.->|"uses workspace tools"| node_workspaceengine
node_chatservice -.->|"targets remote files"| node_remote
node_chatservice -.->|"extracts attachments"| node_documents
node_user -->|"requests translation"| node_translation
node_user -.->|"opens conversations"| node_browser

click node_chatui "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/ui/components/ai/ChatInput.kt"
click node_messageui "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/ui/components/message/ChatMessage.kt"
click node_chatservice "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/service/ChatService.kt"
click node_generation "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/ai/GenerationHandler.kt"
click node_provider "https://github.com/ayuilos/miffan/blob/master/ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt"
click node_models "https://github.com/ayuilos/miffan/tree/master/ai/src/main/java/me/rerere/ai/provider/providers"
click node_toolcontract "https://github.com/ayuilos/miffan/blob/master/ai/src/main/java/me/rerere/ai/core/Tool.kt"
click node_transformers "https://github.com/ayuilos/miffan/tree/master/app/src/main/java/me/ayuilos/miffan/data/ai/transformers"
click node_assistant "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/model/Assistant.kt"
click node_conversation "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/repository/ConversationRepository.kt"
click node_database "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/db/AppDatabase.kt"
click node_search "https://github.com/ayuilos/miffan/blob/master/search/src/main/java/me/rerere/search/SearchService.kt"
click node_localtools "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/ai/tools/local/LocalTools.kt"
click node_workspaceui "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/ui/components/ai/WorkspaceSelectSheet.kt"
click node_workspacerepo "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/repository/WorkspaceRepository.kt"
click node_workspaceengine "https://github.com/ayuilos/miffan/blob/master/workspace/src/main/java/me/rerere/workspace/WorkspaceManager.kt"
click node_remote "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/repository/RemoteWorkspaceConnectionPool.kt"
click node_documents "https://github.com/ayuilos/miffan/blob/master/document/src/main/java/me/rerere/document/DocxParser.kt"
click node_translation "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/ai/TranslationHandler.kt"
click node_browser "https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/web/routes/ConversationRoutes.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_messageui,node_assistant,node_user toneBlue
class node_chatservice,node_generation,node_provider,node_models,node_toolcontract,node_transformers toneAmber
class node_workspaceui,node_workspacerepo,node_workspaceengine,node_remote,node_modelservice toneMint
class node_conversation,node_database toneRose
class node_search,node_localtools,node_documents,node_translation,node_browser,node_webservices toneIndigo
```

## Components

### Assistant experience

- [Chat interface](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/ui/components/ai/ChatInput.kt): `app/src/main/java/me/ayuilos/miffan/ui/components/ai/ChatInput.kt`
- [Message display](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/ui/components/message/ChatMessage.kt): `app/src/main/java/me/ayuilos/miffan/ui/components/message/ChatMessage.kt`
- [Assistant settings](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/model/Assistant.kt): `app/src/main/java/me/ayuilos/miffan/data/model/Assistant.kt`

### AI runtime

- [Chat orchestration](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/service/ChatService.kt): `app/src/main/java/me/ayuilos/miffan/service/ChatService.kt`
- [Generation handling](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/ai/GenerationHandler.kt): `app/src/main/java/me/ayuilos/miffan/data/ai/GenerationHandler.kt`
- [Provider dispatch](https://github.com/ayuilos/miffan/blob/master/ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt): `ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt`
- [Provider services](https://github.com/ayuilos/miffan/tree/master/ai/src/main/java/me/rerere/ai/provider/providers): `ai/src/main/java/me/rerere/ai/provider/providers`
- [Tool contracts](https://github.com/ayuilos/miffan/blob/master/ai/src/main/java/me/rerere/ai/core/Tool.kt): `ai/src/main/java/me/rerere/ai/core/Tool.kt`
- [Prompt transformers](https://github.com/ayuilos/miffan/tree/master/app/src/main/java/me/ayuilos/miffan/data/ai/transformers): `app/src/main/java/me/ayuilos/miffan/data/ai/transformers`

### Workspaces and tools

- [Workspace interface](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/ui/components/ai/WorkspaceSelectSheet.kt): `app/src/main/java/me/ayuilos/miffan/ui/components/ai/WorkspaceSelectSheet.kt`
- [Workspace management](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/repository/WorkspaceRepository.kt): `app/src/main/java/me/ayuilos/miffan/data/repository/WorkspaceRepository.kt`
- [Local workspace engine](https://github.com/ayuilos/miffan/blob/master/workspace/src/main/java/me/rerere/workspace/WorkspaceManager.kt): `workspace/src/main/java/me/rerere/workspace/WorkspaceManager.kt`
- [SSH workspaces](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/repository/RemoteWorkspaceConnectionPool.kt): `app/src/main/java/me/ayuilos/miffan/data/repository/RemoteWorkspaceConnectionPool.kt`

### Local data

- [Conversation history](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/repository/ConversationRepository.kt): `app/src/main/java/me/ayuilos/miffan/data/repository/ConversationRepository.kt`
- [App database](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/db/AppDatabase.kt): `app/src/main/java/me/ayuilos/miffan/data/db/AppDatabase.kt`

### External capabilities

- [Web search](https://github.com/ayuilos/miffan/blob/master/search/src/main/java/me/rerere/search/SearchService.kt): `search/src/main/java/me/rerere/search/SearchService.kt`
- [Device tools](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/ai/tools/local/LocalTools.kt): `app/src/main/java/me/ayuilos/miffan/data/ai/tools/local/LocalTools.kt`
- [Document extraction](https://github.com/ayuilos/miffan/blob/master/document/src/main/java/me/rerere/document/DocxParser.kt): `document/src/main/java/me/rerere/document/DocxParser.kt`
- [Text translation](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/data/ai/TranslationHandler.kt): `app/src/main/java/me/ayuilos/miffan/data/ai/TranslationHandler.kt`
- [Browser access](https://github.com/ayuilos/miffan/blob/master/app/src/main/java/me/ayuilos/miffan/web/routes/ConversationRoutes.kt): `app/src/main/java/me/ayuilos/miffan/web/routes/ConversationRoutes.kt`

### Other components

- **Android user**
- **Model APIs**
- **Search services**

## Connections

- Android user → Chat interface: sends message (evidence: `README.md`)
- Chat interface → Chat orchestration: submits chat
- Assistant settings → Chat orchestration: configures assistant (evidence: `app/src/main/java/me/ayuilos/miffan/service/ChatService.kt`)
- Chat orchestration → Generation handling: delegates generation (evidence: `app/src/main/java/me/ayuilos/miffan/service/ChatService.kt`)
- Chat orchestration → Provider dispatch: selects provider (evidence: `app/src/main/java/me/ayuilos/miffan/service/ChatService.kt`)
- Provider dispatch → Provider services: dispatches requests (evidence: `ai/src/main/java/me/rerere/ai/provider/ProviderManager.kt`)
- Provider services → Model APIs: sends requests
- Chat orchestration → Tool contracts: uses tools (evidence: `app/src/main/java/me/ayuilos/miffan/service/ChatService.kt`)
- Chat orchestration → Prompt transformers: transforms messages (evidence: `app/src/main/java/me/ayuilos/miffan/service/ChatService.kt`)
- Chat orchestration → Conversation history: manages history (evidence: `app/src/main/java/me/ayuilos/miffan/service/ChatService.kt`)
- Conversation history → App database: persists messages
- Chat orchestration → Message display: streams response
- Chat orchestration → Web search: invokes search (evidence: `README.md`)
- Web search → Search services: queries providers
- Chat orchestration → Device tools: invokes device tools (evidence: `README.md`)
- Android user → Workspace interface: chooses workspace (evidence: `README.md`)
- Workspace interface → Workspace management: manages workspace
- Workspace management → Local workspace engine: uses local engine (evidence: `app/src/main/java/me/ayuilos/miffan/data/repository/WorkspaceRepository.kt`)
- Workspace management → SSH workspaces: manages SSH (evidence: `README.md`)
- Chat orchestration → Local workspace engine: uses workspace tools (evidence: `README.md`)
- Chat orchestration → SSH workspaces: targets remote files (evidence: `README.md`)
- Chat orchestration → Document extraction: extracts attachments (evidence: `README.md`)
- Android user → Text translation: requests translation (evidence: `README.md`)
- Android user → Browser access: opens conversations (evidence: `README.md`)
