README.md
January 13, 2026 · View on GitHub
azoo-key-skkserv
AzooKeyKanaKanjiConverterを変換に利用するskkservです。
AzooKeyKanaKanjiConverterから参照される、ニューラルかな漢字変換システム「Zenzai」で利用するモデルはzenz-v1を利用させていただいています。
zenz-v1はKeita Miwa (𝕏)さんによって開発され、CC-BY-SA 4.0で提供されています。
Linux環境向けのバイナリにはllama.cppのShared Objectを同梱させていただいております。
かつ RUNPATH を $ORIGIN にpatchさせていただいております。
azoo-key-skkservについて
受け取った読みをAzooKeyKanaKanjiConverterで漢字変換し、候補を辞書として返すskkservです。
これにより例えば:
配達業者などそれぞれの熟語は辞書に入っているけれど、繋がったものは登録されていないケースでも候補を表示できます。- 送り仮名が不明瞭であったりする際、送り仮名ごと入力しても候補が表示されます。
- SKKの流儀とは反しそうですが、Zenzaiの強力な変換力により、長文をそのまま変換することも可能です。
- SKKの仕様上ユーザー辞書にそのまま登録されてしまうと思うので、その点はご注意ください。
動作イメージ
https://github.com/user-attachments/assets/614f87b9-062a-4710-92e2-f275eb80703f
インストール
macOS
macOS版はGUIアプリケーションを配布しています。(mtgtoさんありがとうございます!)
Releasesに .dmg ファイルが置いてあるので、そちらからインストールしてください。
CLI版も配布しているので、お好みでお使いください。(GUI版の方がmacOS App Sandboxが設定されているので、より安全です。)
macSKKから使用する場合にはIncoming CharsetにEUC-JP、macSKKの応答エンコーディングにUTF-8を指定してください。
Linux
Linux版はCLI版の配布のみです。
Releasesよりご自身のarchに対応したパッケージをダウンロードし、お好きなところに配置してください。
パッケージ内の azoo-key-skkserv が実行ファイルです。
ダイナミックライブラリについて
こちらのLinux検証環境だと libgomp.so.1 が見つからないエラーが出ました。
もし見つからない場合は、以下のようなコマンドでインストールしてください。
apt install libgomp1
使い方
azoo-key-skkserv [--port <port-number>] [--incoming-charset <charset>] [--inference-limit <limit>] [--help] [--version]
EUC-JP範囲外の候補があるため --outgoing-charset オプションはなく、サーバーからは常にUTF-8で返します。
バックグラウンド実行
macOSであれば、ログイン項目にGUI版のアプリケーションを登録しておくのが楽です。
そうでなければ、以下のようなコマンドがログイン時に実行されるようにしてください。
nohup ~/opt/azoo-key-skkserv/azoo-key-skkserv --incoming-charset EUC-JP >&/dev/null &
仕様
skkservの標準に準拠しているつもりです。
入力の1文字目を opcode とし、それ以降を operand とした場合:
| opcode | operand | 説明 | 出力 |
|---|---|---|---|
| 0 | なし | コネクション破棄 | なし |
| 1 | 見出し語 | 辞書要求 | 候補がある時: 1/{候補1}/{候補2}/.../{候補n}/\n候補がない時: 4\n |
| 2 | なし | サーバー情報要求 | azoo-key-skkserv/{バージョン} |
| 3 | なし | ホスト情報要求 | {ホスト名}/127.0.0.1:{ポート}/ |
| 4 | 見出し語 | 補完要求 | 補完がある時: 1/{補完1}/{補完2}/.../{補完n}/\n補完がない時: 4\n |
開発
swift run azoo-key-skkserv
動作検証環境
macOS(Apple silicon)
macSKKと結合して動作確認
macOS(Intel)
動作未確認
Ubuntu(arm64)
macOS上で動作するDockerにて、netcatで動作確認
Ubuntu(amd64)
一応コンパイルできていそうなのですが、エミュレータだとうまく実行できていません。
免責
まだまだ使いながら調整したりしてる段階なので、不具合や不安定なところがあるかと思います。
もし何かございましたら、Issueでご報告いただいたりPRを投げていただけると大変助かります🙇