Skip to content
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2,885 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

logo

Maid - Mobile Artificial Intelligence Distribution

Build Android Test Code Quality

Maid is a free and open source application for interfacing with OpenAI-compatible 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.

About this fork

This is a personal-use fork of Maid that has been deliberately pared down to a single purpose: a lightweight client for OpenAI and OpenAI-compatible endpoints. Compared to upstream Maid, it removes on-device (llama.cpp / llama.rn) inference, all non-OpenAI providers, account sync, voice and image features. The interface has also been rebuilt around Material 3, and the app has been rebranded (as "Maid UI" under its own package id) so it can be installed alongside the original Maid rather than overwriting it. The result is a smaller, leaner app that is gentler on the battery and noticeably more fluid to use.

The motivation is simple: on-device inference and the extra provider integrations added significant binary size, background activity and battery drain that are unnecessary when you only ever talk to a remote endpoint. Stripping them back keeps the UI responsive and the device cool.

Features

  • OpenAI-compatible endpoints — connect to OpenAI or any OpenAI-compatible endpoint (including local servers) with your own API key
  • 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
  • Privacy-first local storage — chats and settings stay on-device by default
  • Material You theming — light and dark themes that follow your system preference
  • Fully open source — MIT licensed, no telemetry, no ads

What's different in this fork

This fork is optimised for personal use, battery efficiency and UI fluidity:

  • Material 3 redesign — the conversation view, settings, navigation drawer, model dropdown, dialogs and long-press menus have been rebuilt around Google's Material 3 / Material You design language, including a full type scale, dynamic light/dark theming, and a redesigned pill composer with an animated send button.
  • Rebranded for side-by-side install — the app has been renamed to Maid UI and ships under its own application id (com.hatsyrei.maid) with its own launcher icon and splash screen, so it installs alongside the original Maid instead of overwriting it.
  • No on-device inference — the llama.cpp / llama.rn engine and model download flow are removed, dramatically reducing app size and eliminating heavy background compute and battery drain.
  • OpenAI-only — the Anthropic, DeepSeek, Mistral, Novita and Ollama providers are removed; the app talks to a single OpenAI-compatible endpoint, which can also be a local server.
  • No accounts or remote sync — authentication and remote backup are removed; everything is stored locally for privacy and to avoid background network traffic.
  • No voice or image features — speech recognition, text-to-speech and image attachments/avatars are removed to slim down permissions and dependencies.
  • Minimal Android permissions — only network-related permissions remain; stale biometric/fingerprint, audio recording, and Play Install Referrer capabilities pulled in by removed libraries are stripped from the manifest.
  • Smoother chat UI — streamed responses are batched through a lightweight writer, message components are memoised, and the conversation list uses a custom scrollbar with tuned virtualisation for fluid scrolling through long histories.

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.

About

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.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages