コマンドライン · 07
Read19 CLI:クラウドKataGoをGUIとスクリプトへ
ネイティブCLIで一度ログインし、GTPまたはAnalysis Engine JSONLを選びます。Sabaki、LizzieYzy、q5Go、KaTrainのどれもローカルでモデルやGPUを管理しません。
ネイティブCLIを導入してログインする
/cliからOSとチップに合うネイティブ版を取得し、SHA-256を確認して展開します。read19はmacOSなら~/.local/bin/read19、WindowsならC:\Tools\read19.exeのような固定の場所に置きます。macOS版は未公証のため、ブラウザで取得した場合は先にxattr -d com.apple.quarantine read19を実行します。続けてread19 login(ブラウザがない環境は--no-open)とread19 engine setup --name "MacBook · Sabaki"で、このクライアント専用のキーを作成・保存します。
loginはアカウント認可、engine setupはこのクライアントだけ失効できる認証情報の作成です。 GUIではengine gtpを選ぶ
デスクトップから起動したGUIはターミナルのPATHを読まないため、必ず絶対パスで指定します。Sabaki:エンジン → エンジンを管理… → 追加で、パスにread19の絶対パス、引数にengine gtpを入れ、エンジンサイドバーで読み込んでF4で解析を切り替えます。LizzieYzy:エンジン管理で、コマンドに「/絶対パス/read19 engine gtp」を一行で入れます。CLI 0.2.14以降が必要です。q5Goも同じパスとengine gtpを使います。KaTrainはGTPを使わず、ローカルエンジンの「エンジンコマンドの上書き」に「/絶対パス/read19 engine analysis」を入れるか、アカウントページのWebSocket URLを使います。
GUIからはローカルGTPプロセスに見え、CLIが局面をクラウド要求へ変換してGTP応答を返します。 スクリプトではengine analysisを選ぶ
完全なJSONが必要ならread19 engine analysisを実行し、stdinへ一行ずつAnalysis Engine queryを書き、stdoutから結果を行ごとに読みます。stdinを閉じると、CLIは送信済みqueryの最終結果を待ってから終了します。read19 usage、statement、statusで使用量、明細、稼働状態を確認できます。GUIの連続解析は止めるまで探索を続けるので、盤面を見ていない間は解析を止めてください。
JSONL経路はGUIを通らず、シェル、Python、Node.js、一括研究ツールに向きます。
コマンド一覧
成功の確認
- read19 accountがアカウントを読める
- GUIのエンジン名がKataGo Read19になる
- 候補手が更新され、停止後は増えない
- 使用量に対応タスクが出る