ディレクトリに戻る

tokenbank

メンテナンス: 活発

wink-run/tokenbank

AI エージェントと各プロバイダー間のローカル LLM ゲートウェイ。スマートルーティング、P2P クォータ共有、フルトレース

GitHub で見るホームページ
$ git clone https://github.com/wink-run/tokenbank.git

110

スター

17

フォーク

JavaScript

言語

Apache-2.0

ライセンス

2026-05-09

作成日

2026-11-12

最終プッシュ

Apache-2.0 のローカル LLM ゲートウェイ——エージェントのワンクリックオンボーディング、トークンの完全トレース、ローカルファーストのスマートルーティング、コミュニティ P2P 共有を備え、OpenAI 互換エンドポイント(localhost:11430)で任意のクライアントに対応。README に DeepSeek Harness の記載はなく、dsh は OpenAI 互換エンドポイント経由での接続になります。

DSH 統合

エコシステム関連

作者による申告

安全性監査

未監査

最終検証日

2026-08-27

ライセンス

Apache-2.0

01どんなタスクに使えるのか?

  • AI 利用で消費するすべてのトークンを追跡し、コストの内訳を正確に把握する

    フルチェーントレース(ライブプロキシ+自動重複排除付きセッションインポート)、アプリ・プロバイダー・モデル・デバイス・時間で切り分けたマルチデバイス分析、サブスクリプションと PAYG の比較表示

    複数の AI エージェント(Claude Code、Cursor、Codex、WorkBuddy)を運用し、トークン消費とコストをローカルで一元管理したい開発者

  • クライアントを変更せずに、エージェントを安価なモデルやローカルモデルへ切り替える

    ネイティブのモデル名はそのまま、透過的なプロトコル変換(Anthropic Messages / OpenAI Chat / Codex Responses)、アプリ単位のバインディング、ワンクリックで公式設定へ復元

    ローカルファーストのスマートルーティングと無料枠(Groq、GitHub Models)でコストを抑えつつ、使い慣れたクライアントを維持したい AI エージェントユーザー

  • アイドル状態のコンピュートや API 枠をコミュニティの P2P ネットワークでクレジットに変える

    credits = (output_tokens / 1000) × contribute_rate × quality_multiplier(0.5–1.5)の式でクレジットを獲得。共有モデルへの利用やリモートエージェントの雇用に消費できる

    アイドル状態のローカル GPU や余った上流 API 枠を活用したいユーザー(README は上流の利用規約を守るよう注意喚起)

02DeepSeek Harness への導入方法

前提条件

  • Token Bank を実行する手段——macOS/Windows デスクトップアプリ、Node.js CLI(Linux・サーバー)、または Docker
  • ローカルゲートウェイは LLM リクエストをポート 11430、Web UI をポート 11431 で待ち受けます

インストール手順

  1. 01

    デスクトップ(推奨):Releases からインストーラーをダウンロード——macOS は `.dmg`、Windows は `.exe`——アプリを開いて **Config** でバックエンド URL とリレー API キーを入力

  2. 02

    CLI モード(Linux・サーバー):`git clone https://github.com/wink-run/tokenbank.git`、`cd tokenbank/client`、`npm install`、次に `node cli/gateway.js start`

    $ git clone https://github.com/wink-run/tokenbank.git

  3. 03

    Docker:`git clone https://github.com/wink-run/tokenbank.git`、`cd tokenbank`、次に `docker compose up gateway -d`

    $ git clone https://github.com/wink-run/tokenbank.git

  4. 04

    **Gateway** タブでローカル API キーを作成するか、既存の上流キーを使い、OpenAI 互換クライアントを `OPENAI_BASE_URL=http://localhost:11430/v1` に向ける

導入成功の確認

  • README のクイック curl テストをローカルゲートウェイに対して実行:`curl http://localhost:11430/v1/chat/completions -H "Authorization: Bearer your-local-key" -H "Content-Type: application/json" -d '{"model":"gpt-4o","messages":[{"role":"user","content":"Hello"}],"stream":true}'`

ロールバック

  • Gateway タブで追跡中のアプリに対して **Revert** をクリック——README によると公式設定を復元して追跡を停止します

03DSH 統合と能力の範囲

DSH 統合エコシステム関連

OpenAI 互換のローカルゲートウェイ——OpenAI 互換のクライアントなら `OPENAI_BASE_URL=http://localhost:11430/v1` で接続可能。README には DeepSeek Harness 固有の統合は記載されていません

  • エージェントのワンクリックオンボーディング

    インストール済みエージェント——Claude Code / Codex CLI / OpenCode / Hermes / Kimi Code、Claude Desktop / Codex Desktop / OpenClaw / WorkBuddy、Cursor / Copilot / Qwen / Grok→各アプリをローカルゲートウェイに向ける CLI shim または設定ファイルのパッチ。Track / Revert の状態付き

    CLI shim は BASE_URL(および関連)環境変数を注入。設定ファイルパッチは設定を書き換える(Revert で復元可能)
  • ローカルファーストのスマートルーティング

    アプリごとのルートバインディングまたは未バインドのリクエスト。ローカルソースとコミュニティ共有ソース→チェーン:ローカル Ollama → 無料 API(Groq / GitHub Models)→ サブスクリプション / PAYG → コミュニティ共有 → ポリシーグループ(fallback / round-robin / weighted / latency / direct)

    イグレスガードが送信 max_tokens を上流の上限にクランプ
  • セッショントレースと可観測性

    localhost:11430 経由のライブプロキシトラフィックと、ローカルのセッションログ(~/.claude、~/.codex、WorkBuddy Trace など)→アプリ・プロバイダー・モデル・供給タイプ・デバイス・時間で切り分けたダッシュボード。リクエストごとのルート結果とレイテンシーを記録したコールログ

    自動重複排除:ゲートウェイとセッションファイルの両方で記録された同一呼び出しは 1 回としてカウント
  • ロスレスゲートウェイ圧縮

    整形された JSON(ツール結果、埋め込みデータ)を含むメッセージ→最小化された JSON——上流の入力トークンが減り、意味は不変。ダッシュボードに圧縮回数・削減トークン数・比率を表示

    非 JSON コンテンツはバイト単位でそのまま
  • コミュニティ共有とリモートエージェント

    アイドルコンピュート:ローカル Ollama、余った上流 API 枠、プライベート LAN モデル(外向き WebSocket、受信ポート不要)→コミュニティ共有モデルでクレジットを獲得・消費。コミュニティエージェントを雇用し、タスクを相手のデバイスで実行

    上流の API キーが自分のマシンから出ることはありませんリモートエージェントはソースをダウンロードせずに実行——タスクは相手のデバイスで実行
  • OpenAI 互換エンドポイント

    OpenAI 互換の任意のクライアントまたはツール→単一のローカルアドレス OPENAI_BASE_URL=http://localhost:11430/v1。CLI shim はオンボーディング済みエージェントに ANTHROPIC_BASE_URL / OPENAI_BASE_URL を自動注入可能

04誰に向いているのか?使うべきでない場面は?

向いている用途

  • 複数の AI エージェント(Claude Code、Cursor、Codex、WorkBuddy)を運用し、トークン消費とコストをローカルで一元管理したい開発者
  • ローカルファーストのスマートルーティングと無料枠(Groq、GitHub Models)でコストを抑えつつ、使い慣れたクライアントを維持したい AI エージェントユーザー
  • アイドル状態のローカル GPU や余った上流 API 枠を活用したいユーザー(README は上流の利用規約を守るよう注意喚起)

不向きな用途

  • README には DeepSeek Harness や公式 dsh CLI への言及がまったくありません。汎用の接続経路は OpenAI 互換エンドポイント(`OPENAI_BASE_URL=http://localhost:11430/v1`)のみで、dsh 環境で使えるかどうかはハーネス側の OpenAI プロトコル対応に依存します。

05互換性・メンテナンス・セキュリティ上の注意

  • README には DeepSeek Harness や公式 dsh CLI への言及がまったくありません。汎用の接続経路は OpenAI 互換エンドポイント(`OPENAI_BASE_URL=http://localhost:11430/v1`)のみで、dsh 環境で使えるかどうかはハーネス側の OpenAI プロトコル対応に依存します。
  • デスクトップアプリのインストーラーは macOS(`.dmg`)と Windows(`.exe`)のみ。Linux やサーバーでは CLI モード(`git clone`+`npm install`+`node cli/gateway.js start`)または Docker を使用します。
  • 本プロジェクトは教育・研究目的のみです。利用者は適用される法律・規制・上流サービスの利用規約(額度やコンピュートの共有を含む)を遵守する責任があります。
2026-05-092026-08-26v0.5.17

Apache-2.0 · 活発にメンテナンス中(最新リリース v0.5.17、2026-08-26)

06よくある質問

DeepSeek Harness を Token Bank に接続するには?

README には DeepSeek Harness や dsh 統合の記載がありません。Token Bank は OpenAI 互換エンドポイント——`OPENAI_BASE_URL=http://localhost:11430/v1`——を公開しており、README によると OpenAI 互換のクライアントなら接続できます。ハーネスが OpenAI プロトコルに対応していれば、このエンドポイントを使ってください。

ワンクリックオンボーディングに対応している AI ツールは?

Claude Code / Codex CLI / OpenCode / Hermes / Kimi Code は CLI shim(環境変数注入)、Claude Desktop / Codex Desktop / OpenClaw / WorkBuddy は設定ファイルパッチ、Trae Work はセッションインポート、Cursor / Copilot / Qwen / Grok はセッション統計または `OPENAI_BASE_URL` の設定で対応します。

Token Bank のインストール方法は?

Releases からデスクトップアプリ(macOS `.dmg`、Windows `.exe`)をインストールし、開いたら Config でバックエンド URL とリレーキーを入力。Linux・サーバーでは CLI モード(`git clone`、`npm install`、`node cli/gateway.js start`)、または Docker(`docker compose up gateway -d`)が使えます。

トークンコストはどう削減されるの?

スマートルーティングがまずローカル Ollama、次に無料 API(Groq / GitHub Models)、その後にサブスクリプション / PAYG を優先し、コミュニティ共有をフォールバックとして使用。オプションのロスレス圧縮(`TOKENBANK_COMPRESS=1`)で上流への入力トークンを削減します。各アプリに独自のルートをバインドできます。

エージェントの設定は変更される?元に戻せる?

はい——CLI shim は `BASE_URL` 環境変数を注入し、設定ファイルパッチは設定を書き換えますが、Gateway タブに **Track / Revert** があり、Revert をクリックすると公式設定を復元して追跡を停止します。

08データと出典

  • 作者による申告github.comae678ec7b643…

    Connecting any OpenAI-compatible client

  • 作者による申告github.comae678ec7b643…

    OPENAI_BASE_URL=http://localhost:11430/v1

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-08-27。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。