How xtom0706/arix-app works
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: AiChatLoop.kt AI Chat Loop · ToolManager.kt Tool Dispatch · WakeAudioPipeline.kt Wake Detection · TerminalService.kt Terminal App
Components 22
Voice Interaction
- Wake Detection
wake/src/main/kotlin/com/arix/wake/WakeAudioPipeline.kt - Wake Service
app/src/main/kotlin/com/arix/app/voice/WakeService.kt - Speech Recognition
stt/src/main/kotlin/com/arix/stt/SttEngine.kt - Voice Call
app/src/main/kotlin/com/arix/app/voice/VoiceCall.kt - Speech Output
cloudapi/src/main/kotlin/com/arix/cloudapi/TtsPipeline.kt
Assistant Runtime
- Chat Interface
app/src/main/kotlin/com/arix/app/chat/ChatScreen.kt - AI Chat Loop
app/src/main/kotlin/com/arix/ai/AiChatLoop.kt - Model Providers
cloudapi/src/main/kotlin/com/arix/cloudapi/CloudApiClient.kt - Tool Dispatch
app/src/main/kotlin/com/arix/tool/ToolManager.kt
Assistant Capabilities
- Device and Web Tools
app/src/main/kotlin/com/arix/tool - MCP and Plugins
app/src/main/kotlin/com/arix/tool/McpGateway.kt - Event Workflows
app/src/main/kotlin/com/arix/app/automation/WorkflowTriggers.kt - Long-Term Memory
app/src/main/kotlin/com/arix/app/memory/MemoryManager.kt - Characters and Worlds
app/src/main/kotlin/com/arix/app/role/CharacterCardManager.kt
Data and Backup
- Local Database
data/src/main/kotlin/com/arix/data/db/AppDatabase.kt - Backup and Restore
app/src/main/kotlin/com/arix/app/backup/FullBackup.kt
Linux Terminal
- Terminal App
terminal/src/main/kotlin/com/arix/terminal/TerminalService.kt - Terminal View
terminal-view/src/main/java/com/termux/view/TerminalView.java - Linux Environment
terminal/src/main/kotlin/com/arix/terminal/TerminalEnv.kt
Other components
- User
- Device Audio
- AI and Search Services
Connections 25
- User → Device Audio: speaks to
README.md - Device Audio → Wake Detection: streams audio
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
README.md - Speech Recognition → AI Chat Loop: provides transcript
- Chat Interface → AI Chat Loop: submits conversation
- Voice Call → AI Chat Loop: supports voice chat
README.md - AI Chat Loop → Model Providers: requests completion
README.md - Model Providers → AI and Search Services: calls model APIs
README.md - AI Chat Loop → Tool Dispatch: dispatches tools
README.md - Tool Dispatch → Device and Web Tools: invokes tools
README.md - Tool Dispatch → MCP and Plugins: routes extensions
README.md - Tool Dispatch → Event Workflows: runs workflows
README.md - AI Chat Loop → Long-Term Memory: uses long-term memory
README.md - AI Chat Loop → Characters and Worlds: uses character context
README.md - Long-Term Memory → Local Database: persists memory
- Characters and Worlds → Local Database: stores cards
- Backup and Restore → Local Database: backs up data
README.md - AI Chat Loop → Speech Output: reads responses
README.md - Speech Output → User: plays speech
README.md - User → Terminal View: enters commands
README.md - Terminal View → Terminal App: uses terminal service
- Terminal App → Linux Environment: runs processes
terminal/src/main/kotlin/com/arix/terminal/TerminalService.kt - Device and Web Tools → Terminal App: shares file workspace
README.md