IME 同音異義語リランキング デモ

ひらがな入力に対して、Mozc の候補と本ツールの再ランキング結果を比較表示するデモです。
Streamlit UI 上で、候補順位の変化・形態素分割・トレース情報を確認できます。

このリポジトリの方針

発表用に、実行に必要な最小構成のみを残しています。
実験ノート・調査メモ・補助スクリプトは含めていません。

必要環境

• Docker
• Docker Compose

クイックスタート

make run

起動後:

• http://localhost:8501

停止:

make stop

再起動:

make restart

状態確認:

make ps

ログ確認:

make logs

使い方（デモ）

1. ひらがな入力 に文を入力
2. プロファイル を選択（通常は accuracy-first）
3. 変換・比較 を押下
4. 以下を確認
   • Mozc 出力 と ツール出力
   • 順位スロット比較
   • 候補の上下動
   • 形態素解析
   • 逐次トレース

ディレクトリ構成（最小）

app/
  main.py                     # Streamlit UI
  services/reranker.py        # 候補生成・スコアリング・安全ゲート
data/datasets/
  demo_examples_curated.jsonl # UI用の厳選例文
models/
  meta_reranker.json
  reading_lexicon.json
  reading_lexicon_overlay.json
Dockerfile
docker-compose.yml
Makefile
pyproject.toml
uv.lock
README.md

補足

• モデルは transformers を利用しています。
• docker-compose.yml で IME_ALLOW_HF_DOWNLOAD=1 を有効化しているため、必要なモデル・トークナイザがローカルにない場合は Hugging Face から取得します。
• 初回起動時はモデル取得のため時間がかかることがあります。