How mobile-artificial-intelligence/maid works
Maid is an Android React Native app for chatting with local llama.cpp models or remote model providers. Users choose or download a model, compose prompts and optional images, stream responses, and manage conversations; settings customize model parameters and assistant identity. Optional account sync backs up settings and chat history through Supabase. The graph reflects documented capabilities and sampled provider/context wiring; unsampled screens and persistence details are represented only where the README supports them.
Main entry points: system.tsx Assistant settings · language-model/index.tsx Provider manager · supabase.ts Supabase · chat/index.tsx Chat screen
Components 21
App experience
- Chat screen
app/chat/index.tsx - Prompt composer
components/groups/prompt-input-group.tsx - Message display
components/views/message/content-view.tsx - Model downloads
app/download.tsx - Chat navigation
components/layout/drawer-content.tsx
Model inference
- Provider manager
context/language-model/index.tsx - Local llama.cpp
context/language-model/llama.tsx - Ollama provider
context/language-model/ollama.tsx - Remote providers
context/language-model - Model files
context/language-model/llama.tsx
Conversation and settings
- Conversation state
context/chat.tsx - Local database
utilities/local-db.ts - Assistant settings
context/system.tsx - Voice output
hooks/use-voice.ts - Theme
hooks/use-theme.ts
Account and sync
- Synced preferences
hooks/use-synced-string.ts - Synced images
hooks/use-synced-image.ts - Authentication
hooks/use-authentication.ts - Supabase
utilities/supabase.ts - Account screens
app/account/register.tsx
Other components
- App user
Connections 26
- App user → Chat screen: opens
README.md - Chat screen → Prompt composer: renders
app/chat/index.tsx - Chat screen → Message display: renders
app/chat/index.tsx - Prompt composer → Conversation state: submits prompts
- Message display → Provider manager: requests responses
components/views/message/content-view.tsx - Provider manager → Local llama.cpp: dispatches local
context/language-model/index.tsx - Provider manager → Ollama provider: dispatches provider
context/language-model/index.tsx - Provider manager → Remote providers: dispatches provider
context/language-model/index.tsx - Local llama.cpp → Model files: loads model files
- App user → Model downloads: browses models
README.md - Model downloads → Model files: downloads GGUF
README.md - Chat navigation → Conversation state: manages conversations
README.md - Conversation state → Local database: persists locally
- App user → Assistant settings: customizes assistant
README.md - Assistant settings → Synced preferences: stores preferences
context/system.tsx - Assistant settings → Synced images: stores profile images
context/system.tsx - Synced preferences → Authentication: checks session
hooks/use-synced-string.ts - Synced images → Authentication: checks session
hooks/use-synced-image.ts - Authentication → Supabase: uses client
hooks/use-authentication.ts - Synced preferences → Supabase: syncs settings
hooks/use-synced-string.ts - Synced images → Supabase: syncs images
hooks/use-synced-image.ts - App user → Account screens: registers or logs in
README.md - Account screens → Supabase: authenticates
app/account/register.tsx - App user → Voice output: pairs voice output
README.md - Assistant settings → Voice output: configures voice
context/system.tsx - Assistant settings → Theme: reads theme
context/system.tsx