Ayuilos/Miffan

Miffan

An Android AI app you talk to like a friend, and that can work on your computer.

English · 简体中文 · 繁體中文

Bring the AI service you already use, whether that's an API key for an OpenAI-compatible, Gemini or Claude service, or a ChatGPT subscription through Codex sign-in. Miffan doesn't bundle a model. Your chats and settings stay on your phone.

Each AI partner is one ongoing chat. There's nothing to start, no model to pick and nothing to tune.

• One partner, one conversation. Your history with a partner reads as one timeline across days. Behind the scenes Miffan keeps topics apart, so long chats stay quick and on point.
• Ask several things at once. Unrelated questions run in parallel, and each reply quotes the message it answers.
• Change a partner by telling it. "Keep your answers shorter" adjusts its preferences. Every change to a partner's settings or memory is linked to the message behind it, kept in a history and can be undone.
• See what AI knows about you. Each memory shows where it came from, and you can delete it at any time.

Connect a Mac or Linux desktop over SSH, including over Tailscale, and your partner can open apps, type and click on it while you watch from your phone.

• One shared screen. View and control the desktop from your phone. Touch the screen and you take over right away.
• You stay in charge. By default the partner asks before every action. Each approval is recorded in a permission history that stays even if you delete the chat.
• Guided setup. Easy chat walks you through connecting a computer, checking that it's ready and handing it to a partner.

Watch it work	Approve each step	Connect in a few steps

Supported desktops: macOS, Linux with wlroots-based Wayland (such as niri, Sway or Hyprland), and X11. GNOME and KDE aren't supported yet.

Switch to the professional interface at any time. It uses the same data as easy chat.

• Combine official APIs, compatible gateways, self-hosted endpoints and a Codex subscription.
• Give each assistant its own prompts, model parameters, memory, MCP servers, Skills and web search.
• Run a local Linux workspace on the phone, or let assistants work on remote servers over SSH with files and a terminal.
• Use voice input and output, translate selected text in any app, and chat from a browser on your network.

The feature matrix lists every supported provider, search service, speech engine and tool.

Choose a Miffan rice bowl or the blue whale girl. Their expressions follow the conversation: they eat while you wait, get dizzy while the AI reasons, smile when a reply arrives and doze off at night.

1. Download the latest APK from GitHub Releases. Official builds are for arm64-v8a devices on Android 8.0 or later.
2. On first launch, connect an AI service with an API key or sign in with a supported account.
3. Start chatting.

You can back up to WebDAV or S3-compatible storage, and import data from RikkaHub, Chatbox and Cherry Studio. Prompts, attachments and tool data go only to the services you configure; see PRIVACY.md and SECURITY.md.

Miffan started as a fork of RikkaHub, an open-source Android LLM client, and has since grown into an independent app.

Miffan still takes in selected RikkaHub improvements. Each one is reviewed and listed separately in the release notes (see the upstream sync policy). Upstream copyright and attribution are kept as the license requires. Miffan is not an official RikkaHub release.

git clone https://github.com/Ayuilos/Miffan.git
cd Miffan
./gradlew assembleDebug

The project uses Kotlin, Jetpack Compose and Java 17. Read the contribution guidelines and issue guidelines before opening a pull request. Release and signing steps are in docs/releasing.md.

Miffan is licensed under the GNU Affero General Public License v3.0.