MCPcopy Index your code
hub / github.com/Mobile-Artificial-Intelligence/maid

github.com/Mobile-Artificial-Intelligence/maid @v3.0.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v3.0.0 ↗ · + Follow
248 symbols 717 edges 92 files 3 documented · 1%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

logo

Maid - Mobile Artificial Intelligence Distribution

Build Android Build Manual Test Code Quality

Get it on GitHub Get it on Google Play

Maid is a free and open source application for interfacing with llama.cpp models locally, and with Anthropic, DeepSeek, Mistral, Novita, Ollama and OpenAI models remotely. Maid is built using React Native and is available for Android. The application is designed to be fast, efficient and user-friendly, making it easy for users to interact with their models on the go.

For text to speech functionality check out Maid's companion app Maise.

Features

  • Local inference — run GGUF models fully on-device via llama.cpp; no internet required
  • Remote providers — connect to Anthropic, DeepSeek, Mistral, Novita, Ollama, and OpenAI with your own API key
  • One-tap model downloads — browse and download curated Hugging Face models (Qwen, Phi, LFM, TinyLlama, and more) directly from the app
  • Bring your own model — load any GGUF file from local storage
  • Conversation management — create, rename, delete, export, and import chats as JSON
  • Customisable parameters — tune temperature, top-p, top-k, context length, and other generation parameters per session
  • Custom system prompt — set a global system prompt and assistant persona
  • Voice output — pair with Maise for text-to-speech
  • Optional account sync — register / log in to back up settings and chat history via Supabase
  • Material You theming — light and dark themes that follow your system preference
  • Fully open source — MIT licensed, no telemetry, no ads

Manual

The user manual is available from releases in PDF format, or can be built from source using the instructions below.

Cloning

To clone the repository, use the following command:

git clone https://github.com/Mobile-Artificial-Intelligence/maid.git

Setup

Run the following command to install dependencies:

yarn install

Testing

Run the test suite with:

yarn test

Building

To build the project, use the following command:

yarn build-android

The output APK will be located in the android/app/build/outputs/apk/release directory.

Star History

Star History Chart

Disclaimer

Maid is distributed under the MIT licence and is provided without warranty of any kind, express or implied. Maid is not affiliated with Huggingface, Meta (Facebook), MistralAi, OpenAI, Google, Microsoft or any other company providing a model compatible with this application.

Signing

Signing Key Fingerprint

MD5: BE:AC:29:41:F5:41:D2:26:42:DD:D1:A3:85:21:E1:16

SHA-1: 48:F6:DC:73:09:CE:19:C6:A9:70:7E:A2:9A:B7:6F:42:2D:41:32:30

SHA-256: 83:5E:D2:2E:D8:95:C4:C2:72:D6:98:AA:6E:4E:48:DB:0B:4E:36:DC:CF:70:10:D5:DE:15:03:4A:C9:E1:B9:6F

Upload Key Fingerprint

MD5: C0:86:A0:F3:E8:E5:4D:46:60:8A:37:4E:DB:11:CC:C7

SHA-1: 77:FC:77:2B:21:5E:9F:36:31:79:09:DF:7D:F4:1F:CA:96:0C:39:17

SHA-256: 54:EE:B9:9F:14:38:D9:68:9B:C2:C6:7F:F9:DD:A3:E3:D8:28:D3:80:76:46:B7:24:46:71:9F:61:D9:63:E6:98

License

This project is licensed under the MIT License.

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Function 213
Interface 24
Method 9
Class 2

Languages

TypeScript96%
Kotlin4%

Modules by API surface

context/language-model/llama.tsx10 symbols
components/views/parameter-view.tsx8 symbols
components/views/header-view.tsx8 symbols
app/download.tsx8 symbols
hooks/use-synced-image.ts7 symbols
context/language-model/ollama.tsx7 symbols
utilities/logger.ts6 symbols
context/language-model/types.ts6 symbols
context/language-model/open-ai.tsx6 symbols
context/language-model/mistral.tsx6 symbols
context/language-model/index.tsx6 symbols
context/language-model/anthropic.tsx6 symbols

For agents

$ claude mcp add maid \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page