azooKey/azooKey-Desktop

azooKey-Desktop is an open-source Japanese input method for macOS, written in Swift and powered by the Zenzai neural kana-kanji converter. It provides live conversion, optional LLM-based “Magic Conversions”, and Tuner-backed personalization for a smooth, desktop typing experience.

azooKey‑Desktop – macOS用日本語入力法

何であるか

macOS用のオープンソース日本語IME（入力法エディタ）で、システムのカナ・漢字変換をZenzaiと呼ばれるニューラルモデルに置き換えます。プロジェクトはオプションのLLMベースの「スマート変換」もバンドルし、Tunerという個人最適化サービスと統合されています。

なぜ重要か

伝統的な日本語IMEはルールベースの辞書に依存しています。azooKey‑Desktopは、あなたの入力履歴、カスタム辞書、プロファイルプロンプトから学習できる現代的なニューラルネットワーク（gguf形式）に切り替え、より高い精度の変換を実現します。
モデル重みはGit LFS経由でリポジトリに同梱されているため、重いAIコンポーネントは別ダウンロードではなく、ソースツリーの一部として含まれます。

主な機能（READMEに記載）

Zenzaiニューラル変換 – 高精度なカナ・漢字変換。
- プロファイルプロンプト対応。
- 履歴学習（あなたの使用習慣に適応）。
- ユーザー辞書。
- 個人最適化システムTunerとの統合。
LLM支援「気持ちのいい」変換 – オプションの大規模言語モデルステップで、より自然な表現を提案できます。
リアルタイム変換 – 入力しながら結果が即座に表示されます。
ネイティブAZIK対応 – AZIKキーボードレイアウトと互換性があります。

入手方法（エンドユーザー向け）

リリースパッケージ – Releasesページから.pkgをダウンロードしてインストール。
macOSからログアウトし、再ログイン。
システム設定 → キーボード → 入力ソースを開き、+をクリックして日本語 → azooKeyを選択し、確認。
メニューバーアイコンからazooKeyを選択。

別案: brew install azooKey（Homebrew）。インストール後もログアウト/ログインと入力ソースの追加が必要です。

ソースからのビルド（開発者向け）

必須条件
- macOS 15+（15でテスト済み、14/26でも動作するが検証未実施）
- Xcode 26.1+（Apple Developer Programに参加していない場合でも、個人チーム署名が可能）
- Git LFS（モデルファイルを取得するために必須）
- SwiftLint（コードスタイルチェック）

サブモジュールとLFSでクローン

git lfs install
git clone https://github.com/azooKey/azooKey-Desktop --recursive
cd azooKey-Desktop
# 既にLFS/サブモジュールなしでクローン済みの場合：
git submodule update --init
git -C azooKeyMac/Resources/zenz-v3.1-small-gguf lfs pull
git -C azooKeyMac/Resources/base_n5_lm lfs pull

署名設定 – azooKeyMac.xcodeprojを開き、Teamを個人チームに変更し、バンドル識別子（dev.ensan…）を所有するものに置き換える。
ビルド＆インストール
```
./install.sh   # .pkgインストーラーと同じ結果を生成
```
スクリプト終了後、上記のログアウト/入力ソース手順を再実行。
トラブルシューティング – READMEにはよくある署名エラー、Xcodeバージョンの問題、モデルファイルが実際に存在しているかの確認方法（数十MBあるべきで、134バイトのLFSポインタではない）が記載されています。

コミュニティと拡張

サポート・貢献用Discordサーバー：https://discord.gg/dY9gHuyZN5
他のプラットフォーム用フォーク：
- fcitx5‑hazkey – Linuxクライアント。
- azooKey‑Windows – Windowsクライアント。
- azoo‑key‑skkserv – SKKサーバー実装。

資金調達

GitHub Sponsorsによる支援を受け付けています。
日本のIPA Mito‑IT人材育成プログラム（2024年）による支援。

結論 azooKey‑Desktopは本格的なAI強化ソフトウェアプロジェクトです：日本語入力用のニューラル言語モデルをバンドルし、オプションのLLMベースの最適化を提供し、macOS開発者が貢献またはカスタマイズしたい場合に完全なビルド手順を提供しています。

azooKey/azooKey-Desktop

azooKey‑Desktop – macOS用日本語入力法

関連