メインコンテンツまでスキップ

はじめに

Yabanin — Your Agnostic Bridge Across Numerous Inference Networks(Y·A·B·A·N·I·N のバクロニム。パッケージは github.com/reireirei/yabanin、CLI のコードネームは yabanin)は、1 つのコントロールプレーンで次の 3 つを行う、OpenAI 互換の AI ゲートウェイです。

  1. コストを評価する — ローカルの支出監査が、使用量ベースの見積もりと、キャッシュおよび経路のシミュレーションを分けます。節約額は、ワークロードと許容できる出力品質に依存します。
  2. リクエスト処理を制御する — プロバイダ経路、リトライ、フォールバックは、設定された導入と障害の限界の範囲で、耐障害性を高められます。
  3. リクエストの証拠を検査する — 任意の署名付きリネージが、モデル、リージョンの証拠、ログの管轄を記録します。署名が検証するのは記録された主張であり、物理的な処理場所を独立に検証するものではありません。

Yabanin には、自社運用のゲートウェイと支援サービスが含まれます。外部プロバイダ、ストレージ、ローカルのモデルエンドポイントを含むリクエスト経路全体を、導入要件に照らして評価してください。ゲートウェイだけを自社運用しても、外部の推論がローカルに留まるわけではありません。

アーキテクチャ​

ソリューションアーキテクチャ は、コンポーネントの所有、リクエスト処理、証拠の保存、MCP の経路、導入を、Mermaid 図とともに説明します。

Client ──► Gateway (:8082) ──► Upstream provider (OpenAI / Anthropic / sovereign / open-weights)
│ ├─ Postgres 16 (sessions, rules, models, lineage ledger, audit logs)
│ ├─ Redis 7 (semantic cache, event stream, rate limiting)
│ └─ Embedder (sentence-transformers / bge for semantic caching)
│
├─ Loggerd (:8085) ←── Redis stream consumer → Postgres persistence
├─ Admin (:8086) — Control plane API, dashboard, policy management
└─ MCP (:8787/SSE) — Partner bridge (stdio + HTTP-SSE)

1 つのバイナリ、4 つのコンポーネントです。統合された yabanin バイナリは、すべてのコンポーネントをプロセス内で実行します(yabanin [gateway|admin|loggerd|mcp]。compose スタックがない場合、yabanin dev がスタック全体を単一プロセスで起動します)。レガシーのコンポーネント別バイナリ(yabanin-gateway、yabanin-loggerd、yabanin-admin、yabanin-migrate)は、Docker イメージ用に引き続きビルドされますが、主たる経路ではありません。ゲートウェイは Postgres からルールを読み、イベントを Redis に発行します。loggerd は、リクエストログを書き込む Redis ストリームのコンシューマです。admin は、方針、レジデンシー、リネージ検証、コンプライアンス報告のためのコントロールプレーンです。mcp は、Model Context Protocol を介して、パートナーとエージェントの連携を橋渡しします。

すでに構築されているもの​

リポジトリには、次の実装領域が含まれます。「実装が存在する」は、エンタープライズ対応の認定ではありません。導入と障害のシナリオには、環境固有の検証が必要です。

レイヤ状態
OpenAI 互換プロキシ + SSE ストリーミング実装が存在する
マルチプロバイダ + フォールバック + サーキットブレーカー + リトライ実装が存在する
セマンティックキャッシュ(pgvector + Redis)実装が存在する
タスク分類器(ルール V0 + ML V1)実装が存在する
コスト / FinOps ダッシュボード(React + Vite)実装が存在する(コスト、クレジット、キャッシュ、分類器のページ)
プリペイドクレジットの請求、チーム予算、支出アラート実装が存在する
組織の上限とベータクレジット(組織ごとの失敗時クローズの RPM/TPM、クレジット枯渇時の 402、スターター付与、組織スコープのクレジット表示)実装が存在する — 組織のセットアップ を参照
管轄リネージのアテステーション(Ed25519)実装が存在する
マルチリージョンのアクティブ-アクティブ(RLS + フェイルオーバー)実装が存在する
エアギャップ / オンプレミスのシングルテナント + ライセンス/PKI実装が存在する
ソブリンモデルのレジストリ + アジアの方針パック(SG/IN/ID/JP)実装が存在する(OpenAI 互換アダプタであり、パートナーシップではない)
SOC 2 / ISO 27001📝 コントロール草案のワークシート。認定されていない — 認定として提示しないでください
監査ハッシュチェーン実装が存在する — 管理の書き込み経路は、改ざんを検知できる行を書き込みます(ENT-03: row_hash = sha256(prev_hash | serialized row)。並行下でもチェーンは連続し、DR 訓練と結合テストでエンドツーエンドに検証済み)
JIT アクセス📝 pkg/jitaccess パッケージとテストは存在します。管理側の接続は近日公開 — 出荷済みとして提示しないでください
KMS(AWS)📝 失敗時クローズのスタブ — 接続されテストされているのは local / file プロバイダのみです。AWS KMS は近日公開
MCP サーバー実装が存在する
方針パイプライン(YPP) — ゲートウェイのトラフィックに対する宣言的な YAML 方針。組み込みの検出器/ミューテータステップが 20 個、外部 HTTP コールアウト(SSRF ガード付き)、LLM ジャッジ、条件分岐、シャドウから強制へのロールアウト、git-as-code の照合、判断ログ実装が存在する — 方針パイプライン を参照
プロンプトスタジオ(バックエンド) — バージョン管理された組織プロンプト、ラベルバインディング、パーシャル、リクエスト時のレンダリング実装が存在する(API。コンソール UI は作業中)
エンタープライズ ID — SCIM 2.0 プロビジョニング(/scim/v2)、SAML 2.0 の管理 SSO、JWT からゲートウェイキーへの認証(JWKS)実装が存在する — SSO(OIDC)、SSO(SAML) を参照
可観測性のエクスポート — GenAI セマンティック規約の属性を付けた OTLP/HTTP 経由のリクエストログ、S3/GCS へのログエクスポート、支出照合の請求書取り込み実装が存在する
エージェントのライフサイクル(エージェントキー yag_、TTL と付与上限付きの委任、ロールプロファイル、エージェントごとおよびタスクごとの予算、MCP ツール付与、タスクタグのコスト利用分析、PR ゲートとしての評価)実装が存在する — エージェントガバナンス と エージェンティック開発 を参照
BYOK — 組織のプロバイダキー(組織ごとの上流資格情報、保存時は enc: で暗号化、API/UI ではマスク、組織で分離された RLS)実装が存在する — BYOK を参照
メンバー招待とウェルカムオンボーディング(招待トークン、初回ログインの 3 ステップ: プロバイダキー → ゲートウェイキー → クライアント設定)実装が存在する — 組織のセットアップ を参照
オーナーフィードバックとベータテレメトリ(フィードバックページ、ベータメトリクスのビュー、Grafana ダッシュボード、ステータスページ、Telegram アラート)実装が存在する — 運用 と 公開スタンドのランブック を参照
SDK(Go / Node / Python)📝 ベータ — 薄いラッパー。Python/Node は文書化された API と一致します
バーティカルパック(金融、医療、法務、…)📝 型付きのレジデンシールールプリセット + リネージフックであり、認定された Halal/HIPAA/ITAR モジュールではありません

リポジトリの AGENTS.md にある品質ゲートを、手元のチェックアウトに対して実行してください。過去のテスト結果は、新しい導入を認定しません。

次に進む場所​