← sources

I built an offline manga translator for Android that users local AI models

source: reddit (reddit:ClaudeAI)published 2026-10-25 09:42ingested 2026-10-26 02:36

retained text

I built Yomu, an Android app that translates Japanese manga pages on the phone. Open a page in any reader app and tap a floating button. Yomu finds the speech bubbles, reads the Japanese, translates the whole page with a local LLM (llama.cpp), and redraws the bubbles in English, Portuguese, Spanish, French or German. Nothing leaves the phone.

# How I used Claude Code

Claude Code wrote most of the code: the Kotlin app, the overlay service, the Compose UI, and the C++ JNI bridge to llama.cpp. My job was deciding what to build, reviewing, and testing on my phone. These are the parts of the setup that made it work:

* **AGENTS.md** **sets the rules**. Open a GitHub issue first, then one branch and one git worktree per issue, so several Claude sessions can work at the same time without clashing. Write the failing test first and commit after each test passes.
* **ADRs settle decisions**. Each choice (which model, how to prompt it, how to draw the text) is recorded with its measurements. Without them, a new session would happily re-argue a decision made two weeks earlier.
* **Claude checks its own work on an emulator**. Through an Android MCP server and adb, it installs the build, opens a manga page, taps the button and reads the result. A script translates one page on \`main\` and on the branch and compares the two page reports, so rendering regressions show up before I look.
* **Spikes before features**. For questions like "can a 1.5B model translate a whole page in one call", Claude ran a throwaway experiment, posted the numbers on the issue, and only then wrote the real code. That's how the page-level call with a GBNF grammar replaced translating bubble by bubble.
* **Memory for lessons learned**. When something bites once, it goes into AGENTS.md or Claude's memory. One example: GitHub only links a PR to an issue with a bare \`Closes #44\`. A markdown link like \`Closes \[#44\](...)\` silently does nothing, and four PRs lost their links before that became a rule.

# What didn't work well

* Claude sometimes declares something done when only the tests pass. That's why the emulator check is required for UI and overlay changes.
* Long sessions drift from the rules, so the important rules live in files, not in chat.

# Try it

It's free and open source (AGPL-3.0), with no accounts and no ads. Download the APK from GitHub Releases, or add the repo to Obtainium for updates. The app needs an arm64 phone and a one-time model download of about 1.1 GB.

[https://github.com/artsaraiva/yomu](https://github.com/artsaraiva/yomu)

document fetched 2026-10-26 00:22 · canonical https://reddit.com/r/ClaudeAI/comments/1xey4sj/i_built_an_offline_manga_translator_for_android