vibedonate

vibedonate

パッケージ · セットアップ · 実行環境 · 比較

vibedonate は、コーディングエージェントを使用する開発者向けの、オープンソースでセルフホスト可能なコンピューティング共有実験です。 ハードウェアを任意で提供し、使用量を計測します。Vibe Suite で、ピア間通信、提供量の制御、ローカル台帳を利用できます。 現在の CLI メッシュは echo スタブを実行します。独立した Ollama ランナーはメッシュジョブに接続されていません。

インストール

npm install -g vibedonate

Node.js 18 以降が必要です。TypeScript 宣言と、直接依存するランタイム依存関係が 3 つ含まれています。

最初のローカルチェックを実行する

vibedonate status

新規インストール時には、ノードが有効化されていないことを示す出力が表示されます。 認証情報や環境変数は不要です。このコマンドによって共有が開始されることはありません。 CLI はエクスポート済みの環境変数を読み取ります。.env ファイルは読み込みません。

オプトイン方式の通信デモを実行するには、1 つ目のターミナルで提供側を起動します。

vibedonate share --compute --idle 00:00-23:59 --cap 2M --pool allowlist:consumer --handle donor

2 つ目のターミナルで利用側を起動します。

vibedonate request "hello" --pool allowlist:consumer --handle consumer

UTC の時間枠内で接続可能なピアがあると、利用側に olleh と表示されます。これは echo スタブであり、AI 推論ではありません。 Ctrl+C で提供側を停止し、vibedonate stop を実行して保存済みの同意を取り消します。

仕組み

share -> saved config + consent -> Hyperswarm pool discovery
                                      |
consumer prompt -> donor checks -> echo stub -> result + metering receipt

status / MCP preflight -> separate Ollama availability check
payment flags -> stub wallet + local payment ledger

アナウンスには、ハンドル、プール、コンピューティング階層、および任意の支払い条件が含まれます。プロンプトと結果は、接続されたピアリンクを通じて送信されます。 使用量の生データはアナウンスされません。ローカルファイルの既定の保存先は ~/.vibedonate です。

開発の背景

vibedonate は、余剰のローカルコンピューティングリソースを対象に、オプトイン方式の提供量制御を検討するプロジェクトです。 Petals はモデル実行を分散し、Ray Serve はモデル提供インフラストラクチャを提供します。 このパッケージは、実験的なピア間通信を用いて、同意、スケジュール、受取人プール、使用量計測に取り組んでいます。

比較

Petals の研究論文およびRay Serve のドキュメントに照らし、2026-10-14 に確認しました。

特性	vibedonate	Petals	Ray Serve
対象範囲	提供量の制御と echo メッシュのデモ	協調型のモデル推論とファインチューニング	分散型モデル提供
実行	既定のメッシュでは echo スタブを使用	モデルブロックを分散実行	デプロイ済みのモデル提供アプリケーション
インターフェース	Node.js ライブラリ、CLI、エージェントの事前チェック	モデル推論インターフェース	Python のデプロイおよび推論 API

対応状況

統合または階層	状況	実装の動作
Hyperswarm	実装済み	同一プール内のピア検出およびリクエスト／結果の通信
Ollama	独立したランナー	実行ファイルを検出し、ollama run を呼び出します。メッシュ CLI には接続されていません
Echo メッシュモデル	スタブ	プロンプトを逆順にし、既定のジョブごとに 100 トークンを記録します
USDC / x402 形式の支払い	スタブ	決定論的なウォレット証明とローカル台帳。決済は行われません
Base	スキャフォールド	支払いチェーンのラベルとして受け付けます
Ethereum	スキャフォールド	支払いチェーンのラベルとして受け付けます
Polygon	スキャフォールド	支払いチェーンのラベルとして受け付けます
サブスクリプション共有	—	提供済みの階層はありません
API クレジットのルーティング	—	提供済みの階層はありません

既定のチャットランナーは 1 つ、既定の echo メッシュモデルは 1 つ、MCP ツールは 2 つです。 ソースの確認とローカルテストによって、これらの違いが裏付けられています。認証情報、オンチェーントランザクション、パブリックネットワーク上のサービス保証は検証されていません。

一般的なユースケース

1. Node.js 開発者：エクスポートされたライブラリを通じて、同意と容量に関する判断をテストします。
2. Hyperswarm の実験者：同じプール内のピア間でエコージョブを交換します。
3. Ollama ユーザー：カスタム統合を構築する前に、ローカルのチャットランナーが利用可能か確認します。
4. エージェントのビルダー：MCP の request_capacity を呼び出して、ジョブを実行せずに、提案された寄付の可否を確認します。
5. Vibe Suite ユーザー：自分のマシン上で、ハッシュチェーン化された使用状況と支払いの記録を確認します。

機能

• 同意： share は donate:compute を許可し、stop は永続化されたストレージで許可を取り消します。
• スケジュール： UTC のアイドル時間帯と、設定可能な 1 日あたりのトークン上限に対応します。
• 受信者プール： open、org:<id>,<member>、allowlist:<peers> に対応します。
• 計測： チェーン検証メソッドを備えた、ローカルのハッシュチェーン化されたレシート。
• 支払い： 任意の価格メタデータとスタブの支払い記録。デフォルトではジョブは無料です。
• Suite フック： エクスポートされた寄付ライフサイクルフックは、vibe-core のイベントと通知を使用します。

ランタイムのインターフェース

Node.js パッケージは、設定パーサー、同意ヘルパー、容量評価、計測、支払いスタブ、コンピューティングの解決機能をエクスポートします。

vibedonate share --compute --idle HH:MM-HH:MM --cap 2M --pool open
  [--handle name] [--price 0.001] [--chain base|ethereum|polygon]
vibedonate request "prompt" --pool open
  [--handle name] [--timeout milliseconds] [--pay 0.001]
vibedonate status
vibedonate stop
vibedonate wallet
vibedonate mcp
vibedonate --help / -h
vibedonate --version / -v

vibedonate mcp は、次の 2 つのツールのみを備えた stdio の Model Context Protocol（MCP）サーバーを起動します。

ツール	動作
status	設定、同意、コンピューティングの利用可否、スケジュールの状態、合計値
request_capacity	{ peer, tokens } を事前確認し、推論もレシートの作成も行わずに許可／拒否を判定します

配信と動作の制限

CLI のドナーはデフォルトで createEchoModel() を使用します。Ollama をインストールしても、モデル推論に置き換わることはありません。 個別のローカルランタイムは容量レシートを記録しますが、プロンプトは実行しません。 CLI は stubWallet() を使用します。支払いの成功とは、合成された証明が通過したことを意味し、Base、Ethereum、Polygon 上で USDC が移動したことを意味しません。 ピアの認可では、アナウンスされたハンドルを比較します。組織への所属を認証したり、ハンドルを信頼できる ID に紐付けたりするものではありません。 CLI のアクティビティ確認は、デフォルトで「ビジーではない」と判定します。ドナーには自動のマシンアイドル検出機能は組み込まれていません。 実行中のドナーは、初期状態の設定オブジェクトと同意オブジェクトを保持します。Ctrl+C で停止してください。別プロセスから stop を実行しても、ドナーは終了しません。 メッシュはジョブの実行前に、今日の合計が上限未満かどうかを確認します。そのため、ジョブによって残りの許容量を超える場合があります。 容量の事前確認では、より厳格なリクエスト適合性チェックを行います。どちらの経路でも同じ上限が適用されるとは限りません。 検出のタイムアウトはデフォルトで 15 秒です。試行する各ドナーの待ち時間は最大 6 秒です。経過時間の合計が検出のタイムアウトを超えることがあります。 ハッシュチェーンは記録内容の不整合を検出しますが、ローカルの台帳全体が書き換えられるのを防ぐものではありません。

統合ガイド

• Ollama ランナー：Ollama をインストールして qwen2.5:7b をプルします。別のインストール済みモデルを選択するには、VIBEDONATE_OLLAMA_MODEL を設定します。
• 状態の分離：~/.vibedonate を上書きするには、VIBEDONATE_DIR をエクスポートします。
• デモプール（アクセス制御ではありません）：両方のピアで同じ allowlist:consumer 文字列を使い、リクエストには --handle consumer を指定します。一致するハンドルをアナウンスするピアは、どれでもチェックを通過します。
• 組織プール：org:team,alice のように、メンバーを明示的に含めます。org:team だけでは、どのメンバーも認可されません。
• エージェントのセットアップ：MCP ホストを設定し、stdio 経由で vibedonate mcp を起動します。

ステータス

バージョン 0.4.3 は実験的な段階であり、1.0 より前です。公開事例はまだありません。 公開ドキュメントサイトは設定されていません。運用ガイダンスはこのページ内で完結しています。 サポートについては GitHub の issue をご利用ください。リポジトリへのアクセスが必要な場合があります。 コントリビューションを行う場合は、npm ci、npm run typecheck、npm run build、npm test を実行してください。

FAQ

どの統合が検証済みですか？

vibedonate は、ソースコードで確認できるピア間のトランスポートと、個別の Ollama ランナーを備えています。ローカルテストは、公開ピアやブロックチェーン上での決済を保証するものではありません。

vibedonate はマネージド推論サービスを提供しますか？

vibedonate はお使いのハードウェア上で動作します。マネージド推論プール、可用性保証、ホスト型アカウントサービスは提供しません。

CLI は寄付されたジョブに Ollama を実行しますか？

vibedonate は、デフォルトの CLI メッシュジョブにエコースタブを使用します。Ollama チャットランナーは別のライブラリパスとして用意されています。

vibedonate は Petals とどう違いますか？

vibedonate は、寄付の制御機能とリクエスト／結果メッシュを実験しています。Petals は参加者間でモデルの実行を分散します。

vibedonate は Ray Serve とどう違いますか？

vibedonate は、ローカルの寄付制御機能と CLI 実験を提供します。Ray Serve は、デプロイされたモデルサービングアプリケーション向けのインフラストラクチャを提供します。

vibedonate で実際に USDC を獲得できますか？

vibedonate に付属するのはスタブウォレットとローカルの支払い記録です。CLI は実際のブロックチェーン決済を送信も検証もしません。

stop はアクティブなドナーを終了させますか？

vibedonate の stop は、永続化された設定と同意を変更します。メッシュから退出するには、アクティブなドナープロセスを Ctrl+C で停止してください。

サブスクリプションのクォータや API クレジットを共有しますか？

vibedonate に付属するのはコンピュート階層のみです。サブスクリプションや API クレジットを経由したルーティングは実装されていません。

ライセンス

MIT。