Bring the AI service you already use, whether that's an API key for an OpenAI-compatible, Gemini or Claude service, a ChatGPT subscription through Codex sign-in, an OpenRouter account, or a Magpie gateway on your own computer. Miffan doesn't bundle a model. Your chats and settings stay on your phone.
Chat like a messenger
Each AI partner is one ongoing chat. There's nothing to start and nothing you have 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. A divider shows where a new topic began, and one tap continues the last topic instead.
- Ask several things at once. Unrelated questions run in parallel, and each reply quotes the message it answers.
- Quick answers or careful ones. On a partner's page, choose how long it thinks before replying, from instant to thinking deeply. For one hard question, pick "Think hard this time" in the + menu.
- Abilities when they're needed. When a partner needs your calendar, clipboard or screen time, it asks in the chat and carries on once you allow it.
- Change a partner by telling it. "Keep your answers shorter" adjusts its preferences. With your approval a partner can also change its own name, avatar and instructions. Every change 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.
- Ask for a picture. Pick a drawing model once and any partner can draw, or edit its last picture when you say "change it to…".
- Keep what matters. Long-press a message to save it. The Discover tab gathers your saved messages and recent drawings, and lets you draw or translate without picking a partner.
Partners that work together
Partners can message each other, and you can bring several into one chat.
- Group chats. A host partner splits the work, mentioned partners reply at the same time, and you're notified only when someone mentions you.
- Mention anyone. Type @ in a chat to bring in another partner.
- Your chat list, your way. Pin partners, sort them into groups, and see at a glance who's working (green) or waiting for your approval (blinking amber).
- Kept apart. A partner only recalls chats it took part in, and first contact between two partners needs your OK.
Let your partner use your computer
Connect a Mac, Windows or Linux computer over SSH, including over Tailscale, and your partner can open apps, type and click on it while you watch from your phone. A server or NAS without a screen works too: the partner uses it through commands.
- One shared screen. View and control the desktop from your phone, in portrait or full-screen landscape. While the partner works, the first touch only asks; a second touch takes over.
- High-performance mode. With Sunshine on the computer, the graphics card encodes the picture for lower latency, smoother motion and sound. Miffan sets it up and pairs for you.
- You stay in charge. Choose per computer whether the partner asks first, works on its own or leaves it alone. Each approval is recorded in a permission history that stays even if you delete the chat.
- Tasks that run on schedule. Ask a partner to do something every morning and the computer's own scheduler runs it on time, even while your phone is off (Mac and Linux). A task can be a command or a call to an AI tool already installed there, such as Claude Code, Codex CLI or Gemini CLI. Results come back to the chat when you open Miffan, and "My computers" keeps the output of every run.
- See how a computer is doing. A status page says in one line whether the computer is ready, fixes problems in place and offers updates for the control helper.
- A mini box of its own. Rather keep a partner off your desktop? Give it its own separate mini box on your Mac or Linux computer. It works freely there and hands finished files to a folder on your computer.
- Easy to connect. Easy chat finds computers on your Wi-Fi and on Tailscale. Sign in once with the account password and Miffan switches to its own key; Windows gets a one-step setup script.
Supported desktops: macOS, Windows, and Linux with GNOME, KDE (through their built-in remote desktop), wlroots-based Wayland (such as niri, Sway or Hyprland) or X11.
Approve with a tap
When a partner wants to do something that matters, such as running a command, scheduling a task, adding a calendar event or calling an MCP tool, it asks with a card you can read: one sentence on what it wants to do and the key details, with the raw call one tap away.
- Allow several ordinary requests at once, or always allow a kind of action and take that back later in the permission history.
- Adjust a calendar event's time before it's added.
- When a partner has a question, tap an option or write your own answer.
- Open any finished change to see exactly what it did, then undo or redo just that change.
Professional mode when you want every option
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.
Characters with feelings
Each partner gets its own look: a Miffan rice bowl in four kinds and six colors, the blue whale girl, a photo or an emoji, picked on its Change look page with a live preview, along with how a Miffan moves. 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.
Get started
- Download the latest APK from GitHub Releases. Official builds are for
arm64-v8a devices on Android 8.0 or later. Later updates download and install from inside the app.
- On first launch, Miffan walks you through it in a chat: connect an AI service (one-tap OpenRouter sign-in or an API key), pick a model and your first partner. You can also restore from a backup.
- Start chatting.
The user guide walks through each feature. If something goes wrong, add the Bug reporter partner: it helps you narrow the problem down and writes it up as an issue for you to submit.
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.
Project history
Miffan started as a fork of RikkaHub, an open-source Android LLM client, and has since grown into an independent app.
| When | Release | What changed |
|---|
| Aug 2026 | 2.4.10-miffan.1 | Forked from RikkaHub 2.4.10 and renamed Miffan, with its own app ID so it installs alongside RikkaHub. Added ChatGPT subscription sign-in through Codex. |
| Aug 2026 | 2.4.10-miffan.5 | The animated Miffan bowl characters arrived. |
| Aug 2026 | 3.0.0 | Moved to Miffan's own version numbers, independent of RikkaHub releases. |
| Sep 2026 | 3.1 – 3.3 | First-run setup, encrypted credentials, persistent reply branches and the blue whale girl. |
| Sep 2026 | 3.4 | Remote SSH workspaces. |
| Oct 2026 | 4.0 | Easy chat and letting your partner use your computer. |
| Oct 2026 | 4.1 | High-performance mode for the remote screen, and GNOME and KDE desktops. |
| Oct 2026 | 4.2 | Partner chats and groups, Windows computers and servers without a screen. |
| Oct 2026 | 4.3 | Drawing, a redesigned way to connect a computer, and readable approval cards. |
| Oct 2026 | 4.4 | Scheduled tasks that your computer runs on its own, even while your phone is off. |
| Oct 2026 | 4.5 | A redesigned easy chat: partner, Me and Discover pages, a Change look page, saved messages, and the Magpie gateway. |
| Oct 2026 | 4.6 | A first run that is a chat with Miffan, choosing how long a partner thinks, and a computer status page. |
| Oct 2026 | 4.7 | A partner's own mini box, and a redesigned screen view. |
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.
Build and contribute
You need JDK 17, the Android SDK with NDK 28.2.13676358 and CMake 3.22.1, Node.js with pnpm, and Python 3.
git clone --recurse-submodules https://github.com/Ayuilos/Miffan.git
cd Miffan
(cd web-ui && pnpm install)
rdp/scripts/fetch-sources.sh && rdp/scripts/build-native.sh # FreeRDP and OpenSSL, once
stream/scripts/fetch-sources.sh # Moonlight sources, once
./gradlew assembleDebug
The app is written in Kotlin with Jetpack Compose. 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.
