Repolode
disler

disler/durable-pi

自分のデバイスで動き、クライアントの切断や再起動後も処理を続けるDurable Piエージェントを、Web UI、ターミナル、curlから操作できます。

スター
346
フォーク
94
未解決の Issue
0
最終コミット
27 日前

これは何?

Durable Piは、pi-durableを基盤とする永続的なAIエージェントのネットワークです。各デバイスでは小規模なサーバーdpi-backendが動作し、エージェント、そのSQLiteデータベース、ツールを管理します。クライアントはURLとbearer tokenを使って接続します。全デバイスを監視するWebハブ、dpi-tuiというターミナルクライアント、またはcurlの単一リクエストから接続できます。

エージェントは出力を表示する前に、履歴、キューに入った入力、タスクのチェックポイント、アプリケーションの状態をSQLiteにコミットします。ブラウザーを閉じたり、ターミナルを終了したり、ツールの実行中にマシンが再起動したりしても、最後のチェックポイントから処理を再開します。一部だけ実行された可能性のあるツールは、黙って再実行されるのではなく、中断された結果として扱われます。

このリポジトリには、ログ監視イベントをきっかけに永続的なエージェントを起動し、承認用の修正案を準備する先回り型デモも含まれています。compaction、fork、共有JSONアプリ状態、永続ジョブ、エージェントごとのツール制御に対応しています。デバイスはYAMLファイルで宣言し、SSH、systemd、launchd、またはexe.devを使ってセットアップします。

主な機能

  • 01出力を表示する前に、エージェントの履歴、キューに入った入力、チェックポイントをSQLiteに永続化します。
  • 02クライアントの切断やデバイスの再起動後、最後のチェックポイントから実行を再開します。
  • 03Web UI、ターミナルクライアント(dpi-tui)、プレーンなHTTP APIが、同じエージェントバックエンドを共有します。
  • 04任意のエージェントを任意のエントリーからforkでき、サブエージェントは親エージェントの下にネストされます。
  • 05パス単位のアトミックな更新と409競合検出に対応した、共有JSONアプリ状態を提供します。
  • 06デバイスをYAMLで宣言し、SSH、systemd、launchd、またはexe.devを使ってデプロイできます。

ユースケース

  • 自宅のサーバーやクラウドVMで個人用コーディングエージェントを動かし、どのデバイスからでもアクセスする。
  • ログイベントをきっかけに起動し、確認する前に作業を準備する先回り型エージェントを構築する。
  • インシデント対応中に、複数のエンジニアが同じエージェントを監視し、操作できるようにする。
  • 自社プロダクトのUIの背後に、永続的で複数クライアントに対応したエージェントを組み込む。

クイックスタート

  1. 1

    環境変数テンプレートをコピーし、OPENROUTER_API_KEYを設定します

    cp .env.example .env
  2. 2

    ネットワーク設定テンプレートをコピーします

    cp dpi-network.example.yaml dpi-network.yaml
  3. 3

    すべてのパッケージの依存関係をインストールします

    just install
  4. 4

    このマシンを登録してWeb UIをビルドし、その後バックエンドを起動します

    just net up local

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

  • 実行にはNode.js 24、just、zsh、OpenRouter APIキーが必要です。
  • リモートデバイスでは、パスワードなしのssh接続と、マシンごとのセットアップが必要です。

収録されている特集

トピック

よくある質問

durable-pi とは?
自分のデバイスで動き、クライアントの切断や再起動後も処理を続けるDurable Piエージェントを、Web UI、ターミナル、curlから操作できます。 Durable Piは、pi-durableを基盤とする永続的なAIエージェントのネットワークです。各デバイスでは小規模なサーバーdpi-backendが動作し、エージェント、そのSQLiteデータベース、ツールを管理します。クライアントはURLとbearer tokenを使って接続します。全デバイスを監視するWebハブ、dpi-tuiというターミナルクライアント、またはcurlの単一リクエストから接続できます。
durable-pi は無料で使えますか?ライセンスは?
durable-pi は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
durable-pi は今もメンテナンスされていますか?
活発にメンテナンス中。durable-pi の最終コミットは 2026年10月11日 です。
durable-pi は何に使えますか?
自宅のサーバーやクラウドVMで個人用コーディングエージェントを動かし、どのデバイスからでもアクセスする。 ログイベントをきっかけに起動し、確認する前に作業を準備する先回り型エージェントを構築する。 インシデント対応中に、複数のエンジニアが同じエージェントを監視し、操作できるようにする。 自社プロダクトのUIの背後に、永続的で複数クライアントに対応したエージェントを組み込む。
durable-pi のインストール方法は?
環境変数テンプレートをコピーし、OPENROUTER_API_KEYを設定します: cp .env.example .env ネットワーク設定テンプレートをコピーします: cp dpi-network.example.yaml dpi-network.yaml すべてのパッケージの依存関係をインストールします: just install このマシンを登録してWeb UIをビルドし、その後バックエンドを起動します: just net up local
durable-pi はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/disler/durable-pi

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト