mirumoji 3.0.0rc1

Self-Hostable Japanese Language Immersion Tool

mirumoji

An open-source, self-hosted Japanese immersion toolkit. Drop in a video, an anime episode, a drama, or an audio clip and Mirumoji gives you clickable tokenized subtitles with instant dictionary lookups, Whisper-powered transcription, SRT generation, clip saving, and one-click Anki export. All running locally in Docker, with optional cloud GPU and LLM features

---

Quickstart

Mirumoji runs as a local Docker Compose Application. The quickest way to start is to download the Desktop Launcher for your platform

Detailed Walkthroughs

• Full Walkthrough → GUI Setup

• CLI Setup Walkthrough → CLI Setup

• Manual Setup Walkthrough → Manual Setup

---

Features

Interactive Player	Load any video and .srt subtitles for clickable, tokenized Japanese lines with instant dictionary pop-ups
Transcription & SRT	Generate subtitles and transcribe audio with faster-whisper, on a local or cloud GPU
Dictionary & Analyzer	Wildcard dictionary search (kotobase) + a paste-in text analyzer with furigana
LLM Breakdowns	Optional GPT / Claude / Gemini word & sentence breakdowns with fully customizable prompts
Clips & Anki	Save video segments with their word breakdowns and export them as an Anki deck
Profiles	Keep files, transcripts, clips, and LLM templates organized per profile on the server
CLI & Desktop GUI	Run the docker compose application with mirumoji up or the desktop launcher

---

Help

Documentation	Guides, Full Python API Reference, Full Frontend API Reference
Setup Guide	CLI, GUI, and Manual setup
Using a GPU	Local GPU vs. Modal Cloud GPU
Changelog	Changed Between Versions
Live Preview	View a live preview of the frontend (not backend running)

---

Contributing

Pull Requests, bug reports, and feature requests are all welcome.

See CONTRIBUTING for the dev container setup, quality gates, and PR conventions.