https://github.com/mobile-artificial-intelligence/maid
Maid is a free and open source application for interfacing with llama.cpp models locally, and with Anthropic, DeepSeek, Ollama, Mistral and OpenAI models remotely.
https://github.com/mobile-artificial-intelligence/maid
android anthropic chatbot chatgpt claude deepseek facebook gguf llama llama-cpp mistral mobile-artificial-intelligence ollama openai
Last synced: about 1 month ago
JSON representation
Maid is a free and open source application for interfacing with llama.cpp models locally, and with Anthropic, DeepSeek, Ollama, Mistral and OpenAI models remotely.
- Host: GitHub
- URL: https://github.com/mobile-artificial-intelligence/maid
- Owner: Mobile-Artificial-Intelligence
- License: mit
- Created: 2023-10-17T02:43:31.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2026-10-12T08:46:20.000Z (about 1 month ago)
- Last Synced: 2026-10-13T20:53:03.988Z (about 1 month ago)
- Topics: android, anthropic, chatbot, chatgpt, claude, deepseek, facebook, gguf, llama, llama-cpp, mistral, mobile-artificial-intelligence, ollama, openai
- Language: TypeScript
- Homepage:
- Size: 74.9 MB
- Stars: 2,722
- Watchers: 36
- Forks: 300
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-ChatGPT-repositories - maid - llama.cpp models locally, and with Ollama and OpenAI models remotely. (Chatbots)
README
# Maid - Mobile Artificial Intelligence Distribution
[](https://github.com/Mobile-Artificial-Intelligence/maid/actions/workflows/build-android.yml)
[](https://github.com/Mobile-Artificial-Intelligence/maid/actions/workflows/build-manual.yml)
[](https://github.com/Mobile-Artificial-Intelligence/maid/actions/workflows/test.yml)
[](https://github.com/Mobile-Artificial-Intelligence/maid/actions/workflows/github-code-scanning/codeql)
Maid is a free and open source application for interfacing with llama.cpp models locally, and with [API Route](https://www.api-route.com), Anthropic, DaoXE, DeepSeek, Mistral, Novita, Ollama, [llmman](https://github.com/llmmanorg/llmman), [OrcaRouter](https://www.orcarouter.ai), [LiteLLM](https://github.com/BerriAI/litellm), [Opper](https://opper.ai) 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](https://github.com/Mobile-Artificial-Intelligence/maise).
## Features
- **Local inference** — run GGUF models fully on-device via llama.cpp; no internet required
- **Remote providers** — connect to API Route, Anthropic, DaoXE, DeepSeek, Mistral, Novita, Ollama, llmman, Opper, OrcaRouter, and OpenAI with your own API key, or to a self-hosted LiteLLM proxy for 100+ providers behind one endpoint
- **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](https://github.com/Mobile-Artificial-Intelligence/maise) for text-to-speech
- **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](https://github.com/Mobile-Artificial-Intelligence/maid/releases/latest) in PDF format, or can be built from source using the instructions below.
## Cloning
To clone the repository, use the following command:
```bash
git clone https://github.com/Mobile-Artificial-Intelligence/maid.git
```
## Setup
Run the following command to install dependencies:
```bash
yarn install
```
## Testing
Run the test suite with:
```bash
yarn test
```
## Building
To build the project, use the following command:
```bash
yarn build-android
```
The output APK will be located in the `android/app/build/outputs/apk/release` directory.
## 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](LICENSE).