はじめに
AI-Lib へようこそ
Section titled “AI-Lib へようこそ”AI-Lib は、アプリケーションが AI モデルとやり取りする方法を標準化するオープンソースのエコシステムです。各 AI サービス用にプロバイダー固有のコードを書く代わりに、単一の統合 API を使用し、プロトコル設定が残りを処理します。
核となる考え方
Section titled “核となる考え方”すべてのロジックはオペレーター、すべての設定はプロトコル。
従来の AI SDK は、プロバイダー固有のロジックをコードに組み込んでいます。異なる HTTP エンドポイント、異なるパラメータ名、異なるストリーミング形式、異なるエラーコード。プロバイダーを切り替えると、コードを書き直すことになります。
AI-Lib は別のアプローチを取ります：
- AI-Protocol は YAML マニフェストで各プロバイダーとの通信方法を定義します
- ランタイム実装（Rust、Python、TypeScript、Go）はこれらのマニフェストを読み取り、リクエストを実行します
- ハードコーディングされたロジックはゼロ —
if provider == "openai"のような分岐はどこにもありません
6 つのプロジェクト、1 つのエコシステム
Section titled “6 つのプロジェクト、1 つのエコシステム”| プロジェクト | 役割 | 言語 | バージョン | 配布 |
|---|---|---|---|---|
| AI-Protocol | 仕様レイヤー | YAML/JSON | v0.8.3 | GitHub |
| ai-lib-rust | ランタイム実装 | Rust | v0.9.3 | Crates.io |
| ai-lib-python | ランタイム実装 | Python | v0.8.3 | PyPI |
| ai-lib-ts | ランタイム実装 | TypeScript | v0.5.3 | npm |
| ai-lib-go | ランタイム実装 | Go | v0.0.1 | Go Modules |
| ai-protocol-mock | mock/テスト層 | Python | v0.1.11 | PyPI |
現在のリリースでは V2 能力に加えて、drift、manifest-consumption、compliance-matrix、fullchain、release-gate の実行ガバナンス・ゲートが統合され、--report-only で段階導入できます。
AI-Protocol（仕様）
Section titled “AI-Protocol（仕様）”基盤となるものです。YAML マニフェストは 37 の AI プロバイダーを記述します：エンドポイント、認証、パラメータマッピング、ストリーミングデコーダー設定、エラー分類ルール、機能。
ai-lib-rust（Rust ランタイム）
Section titled “ai-lib-rust（Rust ランタイム）”高性能ランタイムです。オペレーターベースのストリーミングパイプラインが、構成可能なステージ（Decoder → Selector → Accumulator → EventMapper）を通じてレスポンスを処理します。サーキットブレーカー、レートリミッター、バックプレッシャーによる組み込みの耐障害性。Crates.io で公開されています。
ai-lib-python（Python ランタイム）
Section titled “ai-lib-python（Python ランタイム）”開発者フレンドリーなランタイムです。完全な async/await サポート、Pydantic v2 による型安全性、本番グレードのテレメトリ（OpenTelemetry + Prometheus）、インテリジェントなモデルルーティング。PyPI で公開されています。
ai-lib-ts（TypeScript ランタイム）
Section titled “ai-lib-ts（TypeScript ランタイム）”Node.js/npm 向けランタイム。V2 マニフェスト読み込み、統一エラー、ストリーミング、レジリエンス、そして Rust/Python と整合するコンプライアンス行列を提供します。
- 37 のプロバイダー — OpenAI、Anthropic、Gemini、DeepSeek、Qwen など
- 統合ストリーミング — プロバイダーに関係なく同じ
StreamingEvent型 - プロトコル駆動 — すべての動作は YAML で定義され、コードには記述しません
- ホットリロード — 再起動せずにプロバイダー設定を更新可能
- 耐障害性 — サーキットブレーカー、レート制限、リトライ、フォールバック
- ツール呼び出し — プロバイダー間で統一された function calling
- 埋め込み — ベクトル操作と類似検索
- 型安全性 — コンパイル時（Rust）およびランタイム（Pydantic）検証
次のステップ
Section titled “次のステップ”- クイックスタート — 数分で始められます
- エコシステムアーキテクチャ — 各構成要素の関係を理解する
- AI-Protocol — 仕様を詳しく学ぶ
- Rust SDK — Rust で始める
- Python SDK — Python で始める
- TypeScript SDK — TypeScript で始める