はじめに
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 ゲートウェイです。
- コストを評価する — ローカルの支出監査が、使用量ベースの見積もりと、キャッシュおよび経路のシミュレーションを分けます。節約額は、ワークロードと許容できる出力品質に依存します。
- リクエスト処理を制御する — プロバイダ経路、リトライ、フォールバックは、設定された導入と障害の限界の範囲で、耐障害性を高められます。
- リクエストの証拠を検査する — 任意の署名付きリネージが、モデル、リージョンの証拠、ログの管轄を記録します。署名が検証するのは記録された主張であり、物理的な処理場所を独立に検証するものではありません。
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 にある品質ゲートを、手元のチェックアウトに対して実行してください。過去のテスト結果は、新しい導入を認定しません。
次に進む場所
- インストールせずに試す: 公開デモスタンド — yabanin.ai(ドキュメント、ダッシュボード、ゲートウェイ。公開スタンド を参照)
- ローカルで実行する: 開発ガイド
- 自分のプロバイダキーを持ち込む: BYOK
- コスト制御を調べる: セマンティックキャッシュ · タスク分類器
- エージェントのトラフィックを統制する: 方針パイプライン · エージェントガバナンス · MCP ゲートウェイ
- リージョン制御を調べる: リネージアテステーション · レジデンシーの方針パック · ソブリンモデル · マルチリージョン
- 運用する: 本番ランブック · インシデント対応