Overview

The mirumoji package is the unified Python distribution that ships 2 surfaces of the project

Server

The Backend REST API built with FastAPI. The frontend delegates all of heavy processing to it. The following are some of its core features

• Tokenization of Japanese sentenes using fugashi

• Media transcription using faster-whisper

• Data persistence using SQLAlchemy + sqlite3

• Optional routing of heavy GPU work to Modal cloud GPUs

• LLM provider SDK interaction

Launcher

Designed to be a user-friendly front-door to the Mirumoji Docker Compose Application, this sub-package defines a logical core that drives 2 user-facing applications, the CLI and the GUI

Core

Executes system commands using the subprocess module to automatically execute the necessary steps to start mirumoji

CLI

A CLI application built with Typer + Rich and exposed as a package script (mirumoji)

GUI

A Flet Desktop GUI that orchestrate the Docker Compose Application

Abstract

Three Top-Level Modules Sit Alongside Those Sub-Packages

• Paths → Resolved Host / Storage Paths Shared Across The Package
• Exceptions → Package's Exception Hierarchy
• Log → Centralized Logging Setup Shared By The Server, Launcher, And GUI

These pages are generated from the source docstrings with mkdocstrings