MMS Aligner Runtime

Self-contained process runtime for LA Studio forced alignment. The release artifact is mms-aligner-win-x86_64-cpu.zip; users do not need Python installed.

Architecture

src/mms_aligner/
  protocol/     Stable stdin/stdout JSON contract shared with future C++ ports
  application/  Alignment use case orchestration
  core/         Runtime-independent CTC alignment and output formatting
  adapters/     Python ONNX Runtime, audio decoding, and romanization
packaging/      PyInstaller and LA Studio package metadata
tests/          Contract and algorithm tests without the large model

The dependency direction is cli -> application -> core. Adapters implement application ports. A future C++ executable can replace the Python implementation while preserving backend-manifest.json and protocol version 1.

Development

Use Python 3.12 through 3.14 x64 on Windows:

python -m venv .venv
.\.venv\Scripts\python -m pip install -r requirements-dev.lock
.\.venv\Scripts\python -m pytest

Build the packaged runtime:

.\packaging\build-windows.ps1

Artifacts and SHA-256 files are written to dist\release.

The model is intentionally not bundled. LA Studio passes its installed model directory in each request. This runtime and the upstream model have different licenses; review packaging/LICENSES before distribution.