コンテンツにスキップ

Pi

設計上の軽量さ。標準でマルチモデル。

Piはシステムプロンプトを1,000トークン未満に抑えています — 多くの商用エージェントよりも一桁軽量です。エージェントロジックを書き換えずにモデルプロバイダーを切り替えられます。Ollamaで完全ローカル実行も可能です。createAgentSession()で任意のTypeScriptサービスに組み込めます。

Pi CLIMITbadlogic/pi-mono

三つのモード

はじめに

01

Piをインストール

Terminal window
npm install -g @earendil/pi-agent
# macOS alternative
brew install earendil-works/tap/pi
02

モデルを設定

~/.pi/models.jsonを作成し、Piに1つ以上のプロバイダーを指定します。最初のエントリがデフォルトとして使われます。

{
"default": "anthropic-messages/claude-sonnet-4-5",
"providers": {
"anthropic-messages": {
"apiKey": "sk-ant-..."
},
"openai-completions": {
"apiKey": "sk-..."
},
"ollama": {
"baseUrl": "http://localhost:11434"
}
}
}
03

Piを実行 — または組み込む

対話型ターミナルセッション:

Terminal window
pi
# Switch model mid-session
/model openai-completions/gpt-4o
# Fork the current context into a branch
/fork
# View session tree
/tree

SDK経由でプログラマブルに:

import { createAgentSession } from '@earendil/pi-sdk';
const session = await createAgentSession({
model: 'anthropic-messages/claude-sonnet-4-5',
systemPrompt: 'You are a financial analysis agent.',
tools: ['read', 'write', 'bash'],
});
for await (const event of session.run('Analyse Q1 revenue data')) {
if (event.type === 'text') process.stdout.write(event.text);
}

標準ツール

ツール提供形態備考
read標準ファイルおよびディレクトリツリーの読み取り
write標準ファイルの作成と上書き
edit標準既存ファイルへの精密な編集
bash標準シェルコマンドの実行。標準ではサンドボックスなし
Skills (Lazy)アドオンオンデマンドで読み込まれるカスタムスキル定義 — ベースのシステムプロンプトには含まれません
コミュニティプラグインアドオンPiのツールセットを拡張するnpmパッケージ(Web検索、Slack、データベースなど)

モデルプロバイダー

プロバイダーキーモデルデータ送信
anthropic-messagesClaude Sonnet, Haiku, OpusAnthropic API
openai-completionsGPT-4o, o3-mini, o1OpenAI API
google-generative-aiGemini 2.5 Pro / FlashGoogle API
mistralMistral Large, CodestralMistral API
azure · bedrockAzure OpenAI, AWS Bedrockホストモデル御社のクラウドリージョン
ollama · lm-studio · vllmLlama 3, Mistral, Phi-3, Qwen, 任意のGGUFなし — 完全ローカル

Piの使い分け

01

コンテキスト効率が重要 — トークンを節約したい

Piのシステムプロンプトは1,000トークン未満に収まります。Claude CodeやCodexは命令だけでターン毎に8,000〜10,000トークンを消費します。1日に数千回エージェントを呼び出す大量パイプラインでは、このオーバーヘッドが急速に蓄積します。Piはコンテキストウィンドウのほぼ全体を実際のタスクデータに使えます。

02

マルチモデル・ルーティング — タスクごとに異なるモデル、同じエージェントロジック

Piのプロバイダー層がエージェントを基盤モデルから切り離します。高負荷な推論はClaude Opus、高速検索はGemini Flash、コスト重視のバッチ処理はMistral、機密データはローカルOllamaへ — プロバイダーごとにエージェントロジックを書き換えることなく、同じセッションやパイプライン内で振り分けられます。

03

データ主権 — トークンを外に出さない

PiをOllamaまたはLM Studioと組み合わせ、ローカルまたはオンプレミスのマシンで実行してください。データ送信ゼロ、APIキー不要、サードパーティへのログ送信なし。海事ISM Code記録、船員PII、機密契約書など、法域の所在地要件があるデータに最適な構成です。

04

SDK経由で自社プロダクトにエージェントを組み込む

@earendil/pi-sdkcreateAgentSession()を使えば、Next.jsのAPIルート、Expressマイクロサービス、バックグラウンドワーカーなど、任意のTypeScriptサービスに完全なエージェントセッションを組み込めます。イベントのストリーミング、ツール呼び出しの傍受、並列探索のためのセッション分岐、終了時のクリーンな破棄が可能です。MITライセンスのため商用プロダクトでも摩擦なく利用できます。

次に読む