Pi Monorepo

複数LLM対応APIとエージェント実行基盤、coding agent CLI、TUI/Web UI、運用ツールをTypeScriptモノレポで提供。

14.1kTypeScriptMIT

概要

Pi Monorepoはエージェント開発を部品化し、プロバイダ非依存のLLM APIでモデル切替、ツール呼び出し可能なランタイムで状態と手順を編成し、CLI/TUI/Web UIと運用ツールで配布までつなぎます。単一のTypeScriptワークスペースに集約することで、社内アシスタントや自動化を同じ規約・スクリプトでテスト/リリースしやすくします。

課題 vs イノベーション

✕従来の課題	✓革新的ソリューション
プロバイダごとにAPIやストリーミング仕様が異なり、切替コストが高い	複数LLMを単一APIで抽象化し、モデル選定を実装から分離
実行基盤・ツール呼び出し・UIが分断され、リリースが噛み合わない	モノレポに統合し、ワークスペーススクリプトでビルド/チェックを揃える

アーキテクチャ深掘り

Provider-agnostic LLM API

認証・モデル指定・ストリーミング・エラー表現をプロバイダ横断で揃え、上位層はメッセージとツールと出力に集中できる。

ツール呼び出し対応ランタイム

モデル→ツール選択→実行→結果の再投入→継続推論のループを実装し、状態管理と拡張性をランタイム側に寄せる。

CLI/TUI/Web UI と運用ツール

coding agent CLIやTUI/Web UIなどの入口と、vLLM podsのような運用ツールを同一ワークスペースで提供し、ビルド/チェックを統一する。

デプロイガイド

1. リポジトリを取得して依存関係をインストール（npm workspaces）

bash

1git clone https://github.com/badlogic/pi-mono.git && cd pi-mono && npm install

2. 全パッケージをビルドし、チェックを実行

bash

1npm run build && npm run check

3. テスト実行またはソースから起動（一部テストはAPI Keyが必要）

bash

1./.test.sh  # または ./.pi-test.sh

導入事例

コアシーン	対象読者	ソリューション	成果
開発チーム向けターミナルアシスタント	開発チーム	coding agent CLI/TUIでコード相談・修正提案・タスク分解を統合	コンテキスト切替を減らし、修正の回転を上げる
プロダクト基盤のマルチモデル適配層	AI基盤チーム	単一LLM APIでプロバイダ差分を吸収	コスト/要件/品質でモデルを差し替えやすくする
推論運用のデリバリーツールチェーン	Infraチーム	podsツールでvLLM運用を管理	推論エンドポイント提供を加速し、運用を標準化する

制限事項と注意点

LLM関連機能をフルに使うには各プロバイダのAPI Key設定が必要になりやすく、キー依存のテストはスキップされる場合がある。
TypeScript/Node中心のモノレポのため、Python/Go主体の環境では統合境界と配布戦略を別途設計する必要がある。

よくある質問

そのままプロダクション投入できますか？▾

“ツールチェーンの土台”として使うのが現実的です。プロダクションでは秘密情報管理、権限境界、監査ログ、重要フローの統合テストを自前で追加してください。

特定ベンダーへのロックインを避けるには？▾

アプリ側はメッセージ/ツール抽象だけに依存し、モデル選択・ルーティング・認証を設定に寄せます。ベンチマークを用意すると切替が再現可能になります。

ローカルでテストがスキップされる理由は？▾

外部LLMのAPI Keyやネットワークに依存するテストがあるためです。まずはbuild/checkとキー不要のテストを回し、必要に応じてキーを追加してください。

Pi Monorepo

概要

課題 vs イノベーション

アーキテクチャ深掘り

デプロイガイド

1. リポジトリを取得して依存関係をインストール（npm workspaces）

2. 全パッケージをビルドし、チェックを実行

3. テスト実行またはソースから起動（一部テストはAPI Keyが必要）

導入事例

制限事項と注意点

よくある質問

関連プロジェクト