bigfish1913/pi-rust

これは何？

主な機能

• 01rpi-agentおよびrpi-aiクレートを介してエージェントループを組み込めるため、CLIなしでも利用できます。
• 02ネットワーク接続なしでテストやサンプルを実行できる、決定論的なオフラインfauxプロバイダー。
• 03JSONLツリーとして保存され、クラッシュ後に再開できるセッション。
• 04read、write、edit、bash、grep、find、lsの各ツールを標準搭載。
• 05ツール、プロバイダー、コマンドを登録できるcdylib拡張機能向けプラグインABI。
• 06TCP経由で軽量なTUIクライアントに接続するヘッドレスサーバーモード。

ユースケース

• 独自のRustアプリケーションに、カスタムツールやイベント処理を備えたコーディングエージェントを組み込む。
• APIキーやネットワーク呼び出しを使わずに、エージェントのワークフローをオフラインでテストする。
• ローカルマシンでターミナル上のコーディングエージェントを実行し、別のマシンにある軽量クライアントから操作する。
• グローバルCLIと組み込みエージェントの両方で使える、再利用可能なツールプラグインを作成する。

クイックスタート

1. 1

   crates.io から rpi CLI をインストールします（Rust 1.88 以降が必要です）

   cargo install rpi-cli
2. 2

   モデルプロバイダーの API キーを設定します

   export ANTHROPIC_API_KEY=...
3. 3

   対話型ターミナル UI を起動します

   rpi

使う前に知っておきたいこと

• !crates.io またはソースからインストールする場合、Rust 1.88 以降が必要です。
• !Homebrew formula が対応しているのは macOS の Apple silicon のみです。Intel Mac では、ビルド済みインストーラーまたは cargo を使用してください。
• !実際のモデルを使って CLI を実行するには、プロバイダーの API キーまたは models.json の設定が必要です。

収録されている特集

トピック

よくある質問

pi-rust とは？

Rustネイティブでライブラリを中心に設計されたコーディングエージェントのランタイム兼ターミナルCLI（rpi）。プロバイダーアダプター、ツール、永続セッション、安定したプラグインABIを備えています。 rpiはRust製のコーディングエージェント・ランタイムです。プロバイダーアダプター、エージェントループ、ツール、セッションの永続化、ターミナルUI、プラグインABIを担う、組み合わせ可能な10個のクレートで構成されています。同じコードをSDKとして独自プロセスに組み込むことも、対話型TUI、単発実行モード、JSONイベント出力に対応したコマンドラインエージェント`rpi`から直接使うこともできます。

pi-rust は無料で使えますか？ライセンスは？

pi-rust は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

pi-rust は今もメンテナンスされていますか？

活発にメンテナンス中。pi-rust の最終コミットは 2026年11月6日 です。

pi-rust は何に使えますか？

独自のRustアプリケーションに、カスタムツールやイベント処理を備えたコーディングエージェントを組み込む。 APIキーやネットワーク呼び出しを使わずに、エージェントのワークフローをオフラインでテストする。 ローカルマシンでターミナル上のコーディングエージェントを実行し、別のマシンにある軽量クライアントから操作する。 グローバルCLIと組み込みエージェントの両方で使える、再利用可能なツールプラグインを作成する。

pi-rust のインストール方法は？

crates.io から rpi CLI をインストールします（Rust 1.88 以降が必要です）: cargo install rpi-cli モデルプロバイダーの API キーを設定します: export ANTHROPIC_API_KEY=... 対話型ターミナル UI を起動します: rpi

pi-rust はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/bigfish1913/pi-rust