本文へスキップ
Pathrule

ドキュメント

ローカルモデル

Pathruleは、オプションのモデルをお使いのMac上で実行できます。対応するMac、CLIでのインストール・更新・削除の方法、用途、オフラインでの利用、モデルがない場合の動作を説明します。

このページの内容

理解の中には、作業している場所で行うのが最適なものがあります。

Pathrule Intelligenceは、お使いのマシン上でモデルを実行できます。このモデルはオプションで、コードを書くためではなく、ナレッジを理解するためにあります。教えた好みを構造化されたUser Intelligenceに変換したり、ワークスペースのナレッジを、チームが書いたソースに基づくガイダンスへとコンパイルしたりできます。ランタイムはコンパイル済みのガイダンスを使う前に検証し、カバレッジを確認できない場合はソースのテキストにフォールバックします。ローカル推論では、入力が外部のモデルプロバイダーに送られることはありません。

インストールされるもの

インストールされるのは、モデル専用のランタイムとモデル本体の2つです。どちらもPathruleのホームディレクトリ(デフォルトは~/.pathrule、PATHRULE_HOMEを設定している場合はその場所)に配置されます。ランタイムに必要なものはPathruleが用意して検証するため、Macにすでにどのツールが入っているかにインストールは左右されません。

pathrule intelligence install   # download, verify and activate
pathrule intelligence status    # installed version, and whether an update is available
pathrule intelligence update    # move to the latest version
pathrule intelligence remove    # remove it

対応するMacでは、pathrule setupがダウンロードを一度だけ提案します。断った場合は再び尋ねられることはなく、いつでもpathrule intelligence installを実行してインストールできます。

サイズと対応プラットフォーム

用途ナレッジの理解(コードの生成ではありません)
ダウンロードサイズ数ギガバイト。同意する前にpathrule setupがサイズを表示します
プラットフォームApple Silicon Mac、macOS 14(Sonoma)以降

要件は最初に確認されます。Apple Siliconを搭載していないMacや、macOS 14より古いバージョンを実行しているMacでは、セットアップ時にモデルは提案されません。インストールを試みた場合も、数ギガバイトをダウンロードしてから最後に失敗するのではなく、その理由を示して停止します。LinuxとWindowsでは、モデルがなくてもCLIのすべての機能を利用できます。

セットアップ中に問題が発生した場合、メッセージにはどの段階で何が原因か(接続がない、プロキシ、ディスクの空き不足、古いmacOSなど)が示されます。

ライフサイクルと更新

pathrule intelligence statusは、インストールの状態(未インストール、準備完了、更新あり、エラーとその理由)を表示します。

常に次の3点が保証されます。

  • バージョンは検証が済んでから有効化されます。 Pathruleが公開したものと一致しないダウンロードが使われることはありません。
  • ダウンロードの失敗や破損が、有効なバージョンに影響することはありません。 以前にインストールしたモデルがあれば、そのまま残ります。
  • 更新に新しいCLIのリリースは不要です。 pathrule intelligence updateは、公開されている最新のバージョンを取得します。

読み込みとアンロード

モデルは常駐しているわけではありません。必要なときにお使いのマシン上だけで起動し、何かが利用する前に実際に応答できることが確認されます。一定時間使われないと、再びアンロードされます。アイドル状態の後の最初のリクエストは、それ以降のリクエストよりも明らかに時間がかかります。

オフラインでの利用

インストール後は、教えた内容を理解するのにネットワークは必要ありません。ただし、インストールと更新にはネットワークが必要です。Pathrule Cloudを利用している場合、それは別のものです(後述)。

モデルがない場合

ナレッジを届ける機能は、どれもモデルに依存していません。メモリ、ルール、スキル、知見、すでに教えた好みは、モデルがインストールされているかどうかにかかわらず、これまでどおりエージェントに届きます。

新しい好みを教える操作と、モデルを使ったローカルでの理解には、モデルが必要です。モデルがない場合、pathrule me teachは確認できない内容を保存するのではなく、オンデバイスモデルが利用できないことを伝え、インストール方法を案内します。それ以外のpathrule meコマンドは、モデルがなくても動作します。

「ローカル」が意味すること、意味しないこと

ここは正確に述べておく必要があります。

正しいこと: Pathruleに好みを教えると、推論はお使いのデバイス上で実行され、結果はお使いのマシンに保存されます。モデルが受け取るのは、その操作に必要なナレッジや教えた内容であり、リポジトリが自動的にアップロードされるわけではありません。

これも正しいが、別の話: Pathruleには、アカウント、チーム、課金、ワークスペースの同期、モデル自体の配布のためのクラウドサービスがあります。Cloudモードでは、ワークスペースのナレッジに優先順位を付けるために、各プロンプトの冒頭部分がPathrule Cloudに送信されます。またpathrule snapshotは、あなたやエージェントが実行すると、プロジェクトの説明をアップロードします。さらに、Claude Code、Codex、その他のコーディングエージェントを実行する場合、送信した内容にはそのエージェント自身のプロバイダーの境界が適用されます。

境界は1つではなく3つあります。それぞれについてはセキュリティとプライバシーで説明しています。