ja-furigana-cli

furigana CLI バイナリ + ローカル HTTP サーバー。 ja-furigana lib crate のフロントエンド。

Status: v0.1.x (alpha) — 公開 API はまだ変更され得る。

インストール

cargo install ja-furigana-cli

# → ~/.cargo/bin/furigana がインストールされる

GitHub Releases から OS 別の binary をダウンロードする方法もあります (RyuuNeko1107/ja-furigana/releases)。

使い方

# 1 ショット変換 (--mode は tts | hiragana | ruby | kanji | romaji | romaji-kunrei)

furigana lookup '灰桜の散る道'                       # → tts (default)

furigana lookup '灰桜の散る道' --mode ruby           # → {灰桜|はいざくら}...

furigana lookup '灰桜の散る道' --mode hiragana       # → はいざくらのちるみち

furigana lookup '灰桜の散る道' --mode romaji         # → haizakura no chiru michi (ヘボン式)

furigana lookup '灰桜の散る道' --mode romaji-kunrei  # → 訓令式


# 出力ルール: 漢字 → ひらがな化、 アルファベット / 数字 / 記号 → カタカナ統一

furigana lookup 'Anthropic の Claude を使う' --mode hiragana

# → アンソロピックのクロードをつかう

furigana lookup 'PostgreSQL 16 で動かす' --mode hiragana

# → ポストグレスキューエルジュウロクでうごかす


# 対話モード (REPL) — 引数なしで起動 = REPL (Windows なら exe ダブルクリック相当)

furigana

furigana repl --mode hiragana


# 辞書管理

furigana dict pull                       # GitHub Release から最新 furigana-dict を取得

furigana dict pull --version v0.1.3      # version pin

furigana dict add 灰桜 ハイザクラ        # ユーザー辞書に追加

furigana dict list                       # 現状サマリ

furigana dict remove 灰桜

furigana dict import path/to/extra.toml  # 既存 TOML を user 配下に取り込み


# ローカル HTTP サーバー (`/furigana` エンドポイント)

furigana serve                                 # http://127.0.0.1:8000

furigana serve --bind 0.0.0.0:8000             # 外部からも叩く

furigana serve --auto-pull                     # 起動時に最新 dict を自動取得

FURIGANA_TOKEN=<secret> furigana serve         # 認証有効

辞書を最新化する一番シンプルな方法は furigana dict pull してから process を再起動。 無停止運用したい場合は --auto-pull (起動時 1 回) や [auto_update] 定期 polling (config.toml に 1 セクション、admin_tokens 不要) が選択肢。詳細は docs/HTTP_API.md を参照。

データディレクトリの default は 実行ファイルと同じフォルダ (portable 配置)。 --data-dir <path> または FURIGANA_DATA_DIR で上書き可能。

詳細は プロジェクト README を参照。

ライセンス

MIT License.