# xtom0706/arix-app architecture

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

## Overview

Arix is an Android, voice-first AI assistant for phones and watches. Its principal workflow begins with wake-word audio, proceeds through speech recognition and an AI conversation, and can invoke tools to act on device or retrieve information. The product also includes long-term memory, character cards and world books, event-triggered workflows, voice interaction, and backup options. The README documents these capabilities; sampled source confirms selected wake, tool, and terminal behavior, but does not expose the full conversation orchestration, so some documented relationships are cited to the README.

Main entry points: [`app/src/main/kotlin/com/arix/ai/AiChatLoop.kt`](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/ai/AiChatLoop.kt) (AI Chat Loop), [`app/src/main/kotlin/com/arix/tool/ToolManager.kt`](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/tool/ToolManager.kt) (Tool Dispatch), [`wake/src/main/kotlin/com/arix/wake/WakeAudioPipeline.kt`](https://github.com/xtom0706/arix-app/blob/main/wake/src/main/kotlin/com/arix/wake/WakeAudioPipeline.kt) (Wake Detection), [`terminal/src/main/kotlin/com/arix/terminal/TerminalService.kt`](https://github.com/xtom0706/arix-app/blob/main/terminal/src/main/kotlin/com/arix/terminal/TerminalService.kt) (Terminal App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_voice["Voice Interaction"]
  node_wake["Wake Detection"]
  node_wake_service["Wake Service<br/>[WakeService.kt]"]
  node_stt["Speech Recognition<br/>[SttEngine.kt]"]
  node_voice_call["Voice Call<br/>[VoiceCall.kt]"]
  node_speech_output["Speech Output<br/>[TtsPipeline.kt]"]
end

subgraph group_assistant["Assistant Runtime"]
  node_chat["Chat Interface<br/>[ChatScreen.kt]"]
  node_ai_loop["AI Chat Loop<br/>[AiChatLoop.kt]"]
  node_providers["Model Providers<br/>[CloudApiClient.kt]"]
  node_tool_manager["Tool Dispatch<br/>[ToolManager.kt]"]
end

subgraph group_capabilities["Assistant Capabilities"]
  node_tool_catalog["Device and Web Tools"]
  node_extensions["MCP and Plugins<br/>[McpGateway.kt]"]
  node_automation["Event Workflows"]
  node_memory["Long-Term Memory<br/>[MemoryManager.kt]"]
  node_characters["Characters and Worlds"]
end

subgraph group_data["Data and Backup"]
  node_database[("Local Database<br/>[AppDatabase.kt]")]
  node_backup["Backup and Restore<br/>[FullBackup.kt]"]
end

subgraph group_terminal["Linux Terminal"]
  node_terminal_app["Terminal App<br/>[TerminalService.kt]"]
  node_terminal_view["Terminal View<br/>[TerminalView.java]"]
  node_linux["Linux Environment<br/>[TerminalEnv.kt]"]
end

node_user(("User"))
node_audio["Device Audio"]
node_cloud["AI and Search Services"]

node_user -->|"speaks to"| node_audio
node_audio -->|"streams audio"| node_wake
node_wake_service -.->|"runs detection"| node_wake
node_wake -.->|"triggers recognition"| node_stt
node_user -->|"sends a message"| node_chat
node_stt -.->|"provides transcript"| node_ai_loop
node_chat -.->|"submits conversation"| node_ai_loop
node_voice_call -->|"supports voice chat"| node_ai_loop
node_ai_loop -->|"requests completion"| node_providers
node_providers -->|"calls model APIs"| node_cloud
node_ai_loop -->|"dispatches tools"| node_tool_manager
node_tool_manager -->|"invokes tools"| node_tool_catalog
node_tool_manager -->|"routes extensions"| node_extensions
node_tool_manager -->|"runs workflows"| node_automation
node_ai_loop -->|"uses long-term memory"| node_memory
node_ai_loop -->|"uses character context"| node_characters
node_memory -.->|"persists memory"| node_database
node_characters -.->|"stores cards"| node_database
node_backup -->|"backs up data"| node_database
node_ai_loop -->|"reads responses"| node_speech_output
node_speech_output -->|"plays speech"| node_user
node_user -->|"enters commands"| node_terminal_view
node_terminal_view -.->|"uses terminal service"| node_terminal_app
node_terminal_app -->|"runs processes"| node_linux
node_tool_catalog -->|"shares file workspace"| node_terminal_app

click node_wake "https://github.com/xtom0706/arix-app/blob/main/wake/src/main/kotlin/com/arix/wake/WakeAudioPipeline.kt"
click node_wake_service "https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/voice/WakeService.kt"
click node_stt "https://github.com/xtom0706/arix-app/blob/main/stt/src/main/kotlin/com/arix/stt/SttEngine.kt"
click node_voice_call "https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/voice/VoiceCall.kt"
click node_chat "https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/chat/ChatScreen.kt"
click node_ai_loop "https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/ai/AiChatLoop.kt"
click node_providers "https://github.com/xtom0706/arix-app/blob/main/cloudapi/src/main/kotlin/com/arix/cloudapi/CloudApiClient.kt"
click node_tool_manager "https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/tool/ToolManager.kt"
click node_tool_catalog "https://github.com/xtom0706/arix-app/tree/main/app/src/main/kotlin/com/arix/tool"
click node_extensions "https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/tool/McpGateway.kt"
click node_automation "https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/automation/WorkflowTriggers.kt"
click node_memory "https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/memory/MemoryManager.kt"
click node_characters "https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/role/CharacterCardManager.kt"
click node_database "https://github.com/xtom0706/arix-app/blob/main/data/src/main/kotlin/com/arix/data/db/AppDatabase.kt"
click node_backup "https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/backup/FullBackup.kt"
click node_terminal_app "https://github.com/xtom0706/arix-app/blob/main/terminal/src/main/kotlin/com/arix/terminal/TerminalService.kt"
click node_terminal_view "https://github.com/xtom0706/arix-app/blob/main/terminal-view/src/main/java/com/termux/view/TerminalView.java"
click node_linux "https://github.com/xtom0706/arix-app/blob/main/terminal/src/main/kotlin/com/arix/terminal/TerminalEnv.kt"
click node_speech_output "https://github.com/xtom0706/arix-app/blob/main/cloudapi/src/main/kotlin/com/arix/cloudapi/TtsPipeline.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_wake,node_wake_service,node_stt,node_voice_call,node_speech_output,node_user toneBlue
class node_chat,node_ai_loop,node_providers,node_tool_manager toneAmber
class node_tool_catalog,node_extensions,node_automation,node_memory,node_characters toneMint
class node_database,node_backup toneRose
class node_terminal_app,node_terminal_view,node_linux,node_audio,node_cloud toneIndigo
```

## Components

### Voice Interaction

- [Wake Detection](https://github.com/xtom0706/arix-app/blob/main/wake/src/main/kotlin/com/arix/wake/WakeAudioPipeline.kt): `wake/src/main/kotlin/com/arix/wake/WakeAudioPipeline.kt`
- [Wake Service](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/voice/WakeService.kt): `app/src/main/kotlin/com/arix/app/voice/WakeService.kt`
- [Speech Recognition](https://github.com/xtom0706/arix-app/blob/main/stt/src/main/kotlin/com/arix/stt/SttEngine.kt): `stt/src/main/kotlin/com/arix/stt/SttEngine.kt`
- [Voice Call](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/voice/VoiceCall.kt): `app/src/main/kotlin/com/arix/app/voice/VoiceCall.kt`
- [Speech Output](https://github.com/xtom0706/arix-app/blob/main/cloudapi/src/main/kotlin/com/arix/cloudapi/TtsPipeline.kt): `cloudapi/src/main/kotlin/com/arix/cloudapi/TtsPipeline.kt`

### Assistant Runtime

- [Chat Interface](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/chat/ChatScreen.kt): `app/src/main/kotlin/com/arix/app/chat/ChatScreen.kt`
- [AI Chat Loop](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/ai/AiChatLoop.kt): `app/src/main/kotlin/com/arix/ai/AiChatLoop.kt`
- [Model Providers](https://github.com/xtom0706/arix-app/blob/main/cloudapi/src/main/kotlin/com/arix/cloudapi/CloudApiClient.kt): `cloudapi/src/main/kotlin/com/arix/cloudapi/CloudApiClient.kt`
- [Tool Dispatch](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/tool/ToolManager.kt): `app/src/main/kotlin/com/arix/tool/ToolManager.kt`

### Assistant Capabilities

- [Device and Web Tools](https://github.com/xtom0706/arix-app/tree/main/app/src/main/kotlin/com/arix/tool): `app/src/main/kotlin/com/arix/tool`
- [MCP and Plugins](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/tool/McpGateway.kt): `app/src/main/kotlin/com/arix/tool/McpGateway.kt`
- [Event Workflows](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/automation/WorkflowTriggers.kt): `app/src/main/kotlin/com/arix/app/automation/WorkflowTriggers.kt`
- [Long-Term Memory](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/memory/MemoryManager.kt): `app/src/main/kotlin/com/arix/app/memory/MemoryManager.kt`
- [Characters and Worlds](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/role/CharacterCardManager.kt): `app/src/main/kotlin/com/arix/app/role/CharacterCardManager.kt`

### Data and Backup

- [Local Database](https://github.com/xtom0706/arix-app/blob/main/data/src/main/kotlin/com/arix/data/db/AppDatabase.kt): `data/src/main/kotlin/com/arix/data/db/AppDatabase.kt`
- [Backup and Restore](https://github.com/xtom0706/arix-app/blob/main/app/src/main/kotlin/com/arix/app/backup/FullBackup.kt): `app/src/main/kotlin/com/arix/app/backup/FullBackup.kt`

### Linux Terminal

- [Terminal App](https://github.com/xtom0706/arix-app/blob/main/terminal/src/main/kotlin/com/arix/terminal/TerminalService.kt): `terminal/src/main/kotlin/com/arix/terminal/TerminalService.kt`
- [Terminal View](https://github.com/xtom0706/arix-app/blob/main/terminal-view/src/main/java/com/termux/view/TerminalView.java): `terminal-view/src/main/java/com/termux/view/TerminalView.java`
- [Linux Environment](https://github.com/xtom0706/arix-app/blob/main/terminal/src/main/kotlin/com/arix/terminal/TerminalEnv.kt): `terminal/src/main/kotlin/com/arix/terminal/TerminalEnv.kt`

### Other components

- **User**
- **Device Audio**
- **AI and Search Services**

## Connections

- User → Device Audio: speaks to (evidence: `README.md`)
- Device Audio → Wake Detection: streams audio (evidence: `wake/src/main/kotlin/com/arix/wake/WakeAudioPipeline.kt`)
- Wake Service → Wake Detection: runs detection
- Wake Detection → Speech Recognition: triggers recognition
- User → Chat Interface: sends a message (evidence: `README.md`)
- Speech Recognition → AI Chat Loop: provides transcript
- Chat Interface → AI Chat Loop: submits conversation
- Voice Call → AI Chat Loop: supports voice chat (evidence: `README.md`)
- AI Chat Loop → Model Providers: requests completion (evidence: `README.md`)
- Model Providers → AI and Search Services: calls model APIs (evidence: `README.md`)
- AI Chat Loop → Tool Dispatch: dispatches tools (evidence: `README.md`)
- Tool Dispatch → Device and Web Tools: invokes tools (evidence: `README.md`)
- Tool Dispatch → MCP and Plugins: routes extensions (evidence: `README.md`)
- Tool Dispatch → Event Workflows: runs workflows (evidence: `README.md`)
- AI Chat Loop → Long-Term Memory: uses long-term memory (evidence: `README.md`)
- AI Chat Loop → Characters and Worlds: uses character context (evidence: `README.md`)
- Long-Term Memory → Local Database: persists memory
- Characters and Worlds → Local Database: stores cards
- Backup and Restore → Local Database: backs up data (evidence: `README.md`)
- AI Chat Loop → Speech Output: reads responses (evidence: `README.md`)
- Speech Output → User: plays speech (evidence: `README.md`)
- User → Terminal View: enters commands (evidence: `README.md`)
- Terminal View → Terminal App: uses terminal service
- Terminal App → Linux Environment: runs processes (evidence: `terminal/src/main/kotlin/com/arix/terminal/TerminalService.kt`)
- Device and Web Tools → Terminal App: shares file workspace (evidence: `README.md`)
