Mika AI Agent

<div align="center"> <img src="docs/media/logo.png" alt="Mika" width="88" />

Mika

An AI assistant on your phone: say what you need, and it works your apps and the web until it's done.

It works on a hidden background screen, so you can keep using your phone.

<a href="https://github.com/wangzan101/Mika/releases/latest"><img src="https://img.shields.io/badge/Download%20APK-Android%2011%2B-2ea043?style=for-the-badge&logo=android&logoColor=white" alt="Download APK" /></a>

<a href="https://github.com/wangzan101/Mika/stargazers"><img src="https://img.shields.io/github/stars/wangzan101/Mika?style=flat&logo=github&label=Star&color=1f6feb" alt="stars" /></a> <a href="https://github.com/wangzan101/Mika/releases"><img src="https://img.shields.io/github/downloads/wangzan101/Mika/total?label=downloads&color=2ea043" alt="downloads" /></a> <a href="https://github.com/wangzan101/Mika/releases/latest"><img src="https://img.shields.io/github/v/release/wangzan101/Mika?include_prereleases&label=version" alt="version" /></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-lightgrey" alt="license" /></a>

<br/>

<a href="https://trendshift.io/repositories/326940#achievements"><img src="https://trendshift.io/api/badge/trendshift/repositories/326940/daily?language=Kotlin" alt="#1 Kotlin Repository of the Day" width="250" height="55" /></a> <a href="https://trendshift.io/repositories/326940#achievements"><img src="https://trendshift.io/api/badge/trendshift/repositories/326940/weekly?language=Kotlin" alt="#1 Kotlin Repository of the Week" width="250" height="55" /></a> <a href="https://trendshift.io/repositories/326940#achievements"><img src="https://trendshift.io/api/badge/trendshift/repositories/326940/daily" alt="#5 Repository of the Day" width="250" height="55" /></a>

<br/>

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español

<br/> <img src="docs/media/wechat-send-side.gif" alt="From one sentence, Mika opens WeChat on its background screen, finds the contact and sends the message" width="640" />

_{"Send a message to File Transfer": Mika's chat on the left, each step on its background screen on the right (4× speed; chat list blurred)}

</div>

Get things done with one sentence

<table> <tr> <td align="center" width="33%"><img src="docs/media/wechat-group.gif" width="230" alt="Reads through a WeChat group and summarizes today's chat" /><br/><b>"What did the group talk about today?"</b><br/>_{Scrolls through the chat in the background, then sums it up}</td> <td align="center" width="33%"><img src="docs/media/amazon-cart.gif" width="230" alt="Picks a charger on a shopping site and adds it to the cart" /><br/><b>"A charger under $30, rated 4.5 stars or more"</b><br/>_{Adds the pick to the cart and stops before checkout}</td> <td align="center" width="33%"><img src="docs/media/xhs-summary.gif" width="230" alt="Summarizes a creator's recent posts" /><br/><b>"What has this creator posted lately?"</b><br/>_{Opens the app, reads post by post, then sums it up}</td> </tr> </table> <details> <summary>More demos</summary> <table> <tr> <td align="center" width="33%"><img src="docs/media/boss-greet.gif" width="230" alt="Greets recruiters for 3 jobs on a job site" /><br/>Greets recruiters for 3 jobs on a job site</td> <td align="center" width="33%"><img src="docs/media/google-flights.gif" width="230" alt="Finds the cheapest nonstop flight" /><br/>Finds the cheapest nonstop from San Francisco to New York</td> <td align="center" width="33%"><img src="docs/media/hacker-news.gif" width="230" alt="Reads out the top 5 stories and their points" /><br/>Reads out the top 5 stories on a news site</td> </tr> <tr> <td align="center"><img src="docs/media/job-greet.jpg" width="230" alt="Finds jobs and greets recruiters" /><br/>Finds jobs and greets recruiters</td> <td align="center"><img src="docs/media/music-vip.jpg" width="230" alt="Watches ads to unlock music perks" /><br/>Watches ads to unlock music perks</td> <td align="center"><img src="docs/media/food-order.jpg" width="230" alt="Orders takeout with stacked discounts and asks you before paying" /><br/>Orders takeout with stacked discounts, asks before paying</td> </tr> </table> </details>

_{Several demos use apps popular in China: WeChat is the main messaging app there, and Xiaohongshu (RED) is a lifestyle and social platform. Mika isn't tied to them; it works with any app or website on your phone.}

Why Mika

📱 Leaves your screen alone	Opens apps, taps, types and scrolls on a separate background screen while you use your phone as usual; tap the small live view whenever you want to watch
🧩 Works with any app	Looks at the screen and finds buttons the way a person does: no app APIs, no per-app integration
🌐 Call it from any web page	In the built-in browser, say what you want on the page you're reading and it works right there; touch the page and it stops
🧠 Gets better with use	Remembers the preferences you tell it, and turns tasks it finishes into skills so next time is faster and steadier
🔒 Your data stays on your phone	There is no Mika server; use your own model API key, or sign in with a ChatGPT, xAI or OpenRouter account
🆓 Open source and free	Apache-2.0, all code public

Get started in three steps

1. Install: download the APK from Releases.
2. Connect a model: in Settings › Model, pick a provider and enter an API key, or just sign in with an account (models and sign-in).
3. To operate phone apps: follow the "Set up phone control" wizard in Settings and pair wireless debugging on the phone once (setup guide). Skip this if you only want chat, web and files.

Then try saying: "Set alarms for 9:40 and 10:00 tomorrow morning" or "Check the weather at 8 every morning and tell me only if it will rain".

💡 Have a computer handy? Send this to the AI agent on it and it will set everything up for you:<br/> Follow https://github.com/wangzan101/Mika/blob/main/docs/install-with-agent.en.md to install Mika on the Android phone connected over USB.

What it can do

Operate apps	Reads long lists and chat histories, taps and types, shares text into apps; hands logins, verification codes and payments to you
Browse the web	A built-in desktop-class browser that keeps you signed in, reads pages, downloads and uploads; paces itself and hands block pages to you
Your current screen	Double-tap the floating capsule to send the screen you're looking at: "how should I reply?", "note this down"
Schedules and conditions	"Remind me at 9 tomorrow", "do this every Friday"; runs on time in the original conversation
Jump in or stop anytime	Keep talking while a task runs to add or correct things (long-press to withdraw or edit one Mika hasn't picked up yet); after a stop it reports where it got to, and "continue" picks up from there
Hold to talk	Hold the chat input to speak and edit the words before sending; long-press the floating capsule to speak and release to send. Uses the phone’s built-in speech recognition, or a provider’s speech model if it has none
Files and computing	A Linux sandbox per conversation runs Python, Node and shell on the files you send (arm64)
From your computer	AI tools on your computer can hand Mika tasks through CLI + Skill or MCP (use Mika from a computer)

By default Mika runs in Ask mode: it checks with you only before spending money (placing orders, paying) and just does everything else. You can switch to Autonomous mode instead. See Ask and Autonomous.

For how each of these works and the finer details, see features in detail.

<details> <summary>Apps and websites with built-in usage knowledge (anything not listed still works)</summary>

The names are shown as they appear in the knowledge files.

<!-- generated:knowledge:start --> <!-- Generated by ./gradlew updateReadme; do not edit by hand -->

Category	Built in
Apps	阿里巴巴, 支付宝, Android 设置, 百度, 百家号, 哔哩哔哩, BOSS直聘, Chrome, 得到, 大众点评, 抖音, 飞书, Gmail, 京东, 即刻, 快手, 领英, 美团, 美团外卖, 拼多多, QQ, QQ邮箱, QQ音乐, 淘宝, Telegram, 今日头条, Uber, Uber Eats, 微信, 微博, WhatsApp, X, 闲鱼, 小黑盒, 小红书, 知乎
Websites	铁路12306, 1688, Amazon, 百度搜索, 哔哩哔哩, Google Calendar, 携程旅行, 大众点评, 豆瓣, 抖音, GitHub, Instagram, 京东, Gmail, Google Maps, 美团, 淘宝网, Telegram, 百度贴吧, 百度热搜, 微博, 搜狗微信, WhatsApp, 小红书, 小宇宙, QQ音乐, YouTube, 知乎, BOSS直聘
How-to skills	改 Mika 自己的设置, 把内容整理成文字, 处理 PDF 文档, 查清一件事, 消息与邮件, 写技能

<!-- generated:knowledge:end --> </details> <details> <summary>Supported model providers</summary> <!-- generated:providers:start --> <!-- Generated by ./gradlew updateReadme; do not edit by hand -->

Presets for DeepSeek, 通义千问, Kimi, 智谱, 智谱 Coding Plan, 硅基流动, 火山方舟, MiniMax, 阶跃星辰, 腾讯混元, 百度千帆, OpenRouter, Requesty, OpenCode Go, Anthropic, Gemini, OpenAI, xAI, Mistral, Groq, Ollama, LM Studio and more; for any other provider pick Custom (自定义), which takes any OpenAI-compatible, Anthropic, Gemini or OpenAI Responses endpoint.

<!-- generated:providers:end -->

You can also skip the key and sign in with a ChatGPT (Plus / Pro), xAI / Grok or OpenRouter account. Steps for adding a model, and what to know about each sign-in, are in models and sign-in.

</details>

Which phones

	Requirement
Chat, web, files	Android 11 or later
Operating phone apps	Android 12 or later; Android 14+ recommended (the background screen has its own focus, so it doesn't get in the way of your typing on the main screen)
Linux sandbox	arm64 devices

Not sure your phone is up to it? Run Settings › Recovery & repair › Compatibility self-check: 12 checks in about a minute, and you can send us the results in one tap.

Privacy & safety

• There is no Mika server: what you say and what's on your screen go only to the model provider you set up.
• API keys and memories are stored encrypted on the phone; conversations and run records stay on the device; update checks only contact GitHub.
• Operating third-party apps and websites automatically may break their terms of service, so use your own judgment. For anything important, use Ask mode and check the results. See the disclaimer.

<details> <summary><b>FAQ</b></summary>

Wireless debugging turned itself off? Android turns it off when you change Wi-Fi or restart. With your permission, Mika turns it back on by itself; if it still can't connect, go back to "Set up phone control" and pair again.

Can't find wireless debugging on my phone? Some phone systems leave it out. You can start the phone helper from a computer over USB instead; see the setup guide.

Some screens can't be read or captured? Pages like payments and password entry block screenshots, so Mika asks you to take over there.

Can I use a model running on my own computer? Yes: pick "Custom" as the provider and enter its address on your local network.

Is the app in English? Yes. The app UI comes in English, Arabic, Simplified Chinese, Traditional Chinese, Japanese, Korean, Spanish, Portuguese, Russian and Indonesian, follows your system language, and can be switched in Settings › Language. The built-in app and website knowledge is written in Chinese, but that doesn't limit you: the model reads it fine, and you can talk to Mika in English.

Where do updates come from? Only from this repository's Releases; you can also upgrade in the app from About › Check for updates.

More answers are in the FAQ.

</details>

Community & contributing

• Docs: all docs and a suggested reading order are in the docs index
• Community: join the X group chat; to reach the author on WeChat, scan the QR code in the app under About › Contact the author (mention Mika in your request)
• Follow the author: X @wangzan101
• Report a problem: open an issue; About › Send feedback in the app can attach diagnostics
• Contribute: add usage knowledge for an app or website (plain text, no code needed), or contribute code; see the contributing guide

Star History

<a href="https://star-history.com/#wangzan101/Mika&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wangzan101/Mika&type=Date&theme=dark&v=20261110-2017" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wangzan101/Mika&type=Date&v=20261110-2017" width="600" /> </picture> </a>

Contributors

Thanks to everyone who has helped build Mika:

<a href="https://github.com/wangzan101/Mika/graphs/contributors"> <img src="https://contrib.rocks/image?repo=wangzan101/Mika&max=100&columns=12" alt="Contributors" /> </a>

License

Apache-2.0 · NOTICE · Third-party components