ai-lib-python | AI-Protocol Python ランタイ�?/title> <meta name="description" content="ai-lib-python �?AI-Protocol の公�?Python ランタイムです。非同期優先、Pydantic v2 型、本番グレードのテレメトリ、モデルルーティング�? /> <meta name="viewport" content="width=device-width,initial-scale=1" /> <link rel="icon" href="/favicon.svg" /> </head> <body> <SiteHeader locale=ja /> <main>  <section class="relative pt-16 pb-20 overflow-hidden"> <div class="absolute inset-0 -z-10"> <div class="absolute top-0 left-1/4 w-96 h-96 bg-emerald-500/5 rounded-full blur-3xl"> </div> <div class="absolute bottom-0 right-1/3 w-80 h-80 bg-cyan-500/5 rounded-full blur-3xl"> </div> </div> <div class="container"> <div class="max-w-4xl"> <div class="inline-flex items-center gap-2 px-3 py-1 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-400 border border-emerald-500/20 mb-6" > v1.0.0 · PyPI </div> <h1 class="text-4xl md:text-6xl font-extrabold tracking-tight mb-6 leading-[1.05]"> <span class="gradient-text-python">Python ランタイ�?/span> <br /> <span class="text-[var(--text)]">AI-Protocol 向け�?/span> </h1> <p class="text-lg md:text-xl text-[var(--text-dim)] max-w-2xl mb-8 leading-relaxed"> 開発者フレンドリーなプロトコル駆動型 AI クライアント。V2 標準エラーコード�?3種類）、機能ベース�?extras�?つのオプショ�?+ フル）、完全な非同期サポート、Pydantic v2 型安全性、本番グレードのテレメトリ、スマートモデルルーティング。Python 3.10+�? </p> <div class="flex flex-wrap gap-4 mb-8"> <a href="/ja/python/quickstart/" class="inline-flex items-center gap-2 px-6 py-3 bg-emerald-600 text-white font-semibold rounded-lg hover:bg-emerald-700 transition-all hover:no-underline" >クイックスタート</a > <a href="https://github.com/ailib-official/ai-lib-python" target="_blank" rel="noopener" class="inline-flex items-center gap-2 px-6 py-3 border border-[var(--border)] text-[var(--text)] font-semibold rounded-lg hover:bg-[var(--bg-alt)] transition-all hover:no-underline" >GitHub</a > <a href="https://pypi.org/project/ai-lib-python/" target="_blank" rel="noopener" class="inline-flex items-center gap-2 px-6 py-3 border border-[var(--border)] text-[var(--text)] font-semibold rounded-lg hover:bg-[var(--bg-alt)] transition-all hover:no-underline" >PyPI</a > </div> <div class="bg-[#0d1117] border border-[var(--border)] rounded-lg p-4 max-w-lg"> <div class="text-xs text-[var(--text-muted)] mb-2 font-mono">ターミナ�?/div> <code class="text-sm text-emerald-300 font-mono">pip install ai-lib-python</code> </div> </div> </div> </section>  <section class="section-alt"> <div class="container"> <h2 class="text-3xl font-bold text-[var(--text)] mb-10 text-center">主な機能</h2> <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6"> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">V2 エラーコードと機�?extras</h3> <p class="text-sm text-[var(--text-dim)]"> 一貫したエラー処理のための 13 種類�?V2 標準エラーコード。機能ベース�?extras�? つのオプショ�?extras とフ�?extra で最小またはフルインストールに対応�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">非同期優先デザイ�?/h3> <p class="text-sm text-[var(--text-dim)]"> ネイティ�?async/await を全面採用。httpx 駆動のトランスポートとコネクションプーリング。CancellableStream でストリームのグレースフル終了�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">Pydantic v2 �?/h3> <p class="text-sm text-[var(--text-dim)]"> Pydantic v2 バリデーションによる完全な型ヒント。ProtocolManifest、Message、ContentBlock、StreamingEvent �?すべて型安全でランタイム検証付き�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">ResilientExecutor</h3> <p class="text-sm text-[var(--text-dim)]"> ResilientExecutor は背圧、レート制限、サーキットブレーカー、指数バックオフによるリトライを統合。PreflightChecker が実行前にリクエストをゲート�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">モデルルーティン�?/h3> <p class="text-sm text-[var(--text-dim)]"> ModelManager �?ModelArray によるインテリジェントなモデル選択。ラウンドロビン、加重、コストベース、品質ベースのルーティング戦略�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">本番テレメト�?/h3> <p class="text-sm text-[var(--text-dim)]"> Prometheus エクスポート付き MetricsCollector。OpenTelemetry による分散トレーシング。構造化ログ。ヘルスモニタリング。ユーザーフィードバック収集�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">構造化出力</h3> <p class="text-sm text-[var(--text-dim)]"> JSON モード設定、Pydantic モデルからのスキーマ生成、出力検証。コンテンツフィルターと PII 検出のガードレール�? </p> </div> </div> </div> </section>  <section class="section"> <div class="container"> <div class="grid grid-cols-1 lg:grid-cols-2 gap-10 items-start"> <div> <h2 class="text-3xl font-bold text-[var(--text)] mb-4">Pythonic で直感的</h2> <p class="text-[var(--text-dim)] mb-6 leading-relaxed"> 自然に感じるクリーン�?Pythonic �? API。モデル識別子からクライアントを作成し、フルーエントビルダーでリクエストを構築、統一されたストリーミングイベントをイテレート�? </p> <p class="text-[var(--text-dim)] mb-6 leading-relaxed"> 同じコードがすべてのプロバイダーで動作。OpenAI から Anthropic、DeepSeek への切り替えは�? つの文字列を変更するだけ �? プロトコルマニフェストが残りを処理します�? </p> </div> <div> <pre class="text-sm !bg-[#0d1117] !border-emerald-500/20"><code class="language-python"><span style="color:#ff7b72">from</span> ai_lib_python <span style="color:#ff7b72">import</span> AiClient <span style="color:#8b949e"># Works with ANY provider</span> client = <span style="color:#ff7b72">await</span> AiClient.create( <span style="color:#a5d6ff">"anthropic/claude-3-5-sonnet"</span> ) <span style="color:#8b949e"># Streaming chat</span> <span style="color:#ff7b72">async for</span> event <span style="color:#ff7b72">in</span> client.chat() \ .user(<span style="color:#a5d6ff">"Explain AI-Protocol"</span>) \ .temperature(<span style="color:#79c0ff">0.7</span>) \ .max_tokens(<span style="color:#79c0ff">1000</span>) \ .stream(): <span style="color:#ff7b72">if</span> event.is_content_delta: print(event.as_content_delta.text, end=<span style="color:#a5d6ff">""</span>) <span style="color:#8b949e"># Non-streaming with stats</span> response, stats = <span style="color:#ff7b72">await</span> client.chat() \ .user(<span style="color:#a5d6ff">"Summarize this"</span>) \ .execute_with_stats() print(f<span style="color:#a5d6ff">"Tokens: {stats.total_tokens{'}'}"</span>) print(f<span style="color:#a5d6ff">"Latency: {'{'}stats.latency_ms{'}'}ms"</span>)</code></pre> </div> </div> </div> </section>  <section class="section-alt"> <div class="container"> <div class="text-center mb-10"> <h2 class="text-3xl font-bold text-[var(--text)] mb-4">内部アーキテクチ�?/h2> <p class="text-lg text-[var(--text-dim)] max-w-2xl mx-auto"> Rust ランタイムと同じレイヤードアーキテクチャ �? プロトコル駆動、オペレーターベース、デフォルトでレジリエント�? </p> </div> <RuntimeArch locale={locale} variant="python" /> </div> </section>  <section class="section"> <div class="container"> <h2 class="text-3xl font-bold text-[var(--text)] mb-10 text-center">モジュール概�?/h2> <div class="grid grid-cols-1 md:grid-cols-2 gap-6"> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono"> client/ + errors/standard_codes/ </h3> <p class="text-sm text-[var(--text-dim)]"> AiClient、AiClientBuilder、ChatRequestBuilder、ChatResponse、CallStats、CancelToken、CancellableStream�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono">protocol/</h3> <p class="text-sm text-[var(--text-dim)]"> ProtocolLoader（ローカ�?環境変数/GitHub）、Pydantic マニフェストモデル、JSON Schema バリデーター、ホットリロード対応�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono">pipeline/</h3> <p class="text-sm text-[var(--text-dim)]"> Decoder（SSE、JSON Lines、Anthropic SSE）、Selector（JSONPath）、Accumulator、FanOut、EventMapper（プロトコル駆動、デフォルト、Anthropic）�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono">resilience/</h3> <p class="text-sm text-[var(--text-dim)]"> ResilientExecutor、RetryPolicy、RateLimiter、CircuitBreaker、Backpressure、FallbackChain、SignalsSnapshot、PreflightChecker�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono">routing/</h3> <p class="text-sm text-[var(--text-dim)]"> ModelManager、ModelArray、選択戦略（ラウンドロビン、加重、コストベース、品質ベース）。主要プロバイダー向けプリセットカタログ�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono">telemetry/</h3> <p class="text-sm text-[var(--text-dim)]"> MetricsCollector（Prometheus）、Tracer（OpenTelemetry）、構造化 Logger、HealthChecker、ユーザーフィードバック収集�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono"> embeddings/ + tokens/ </h3> <p class="text-sm text-[var(--text-dim)]"> ベクトル操作付き EmbeddingClient。TokenCounter（tiktoken 統合）と使用量追跡のためのコスト推定�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono"> plugins/ + structured/ </h3> <p class="text-sm text-[var(--text-dim)]"> プラグインベースクラス、PluginRegistry、HookManager、ミドルウェアチェーン。JSON モード設定、SchemaGenerator、OutputValidator�? </p> </div> </div> </div> </section>  <section class="section-alt"> <div class="container text-center"> <h2 class="text-3xl font-bold text-[var(--text)] mb-4">Python で開発を始めよう</h2> <div class="flex flex-wrap gap-4 justify-center"> <a href="/ja/python/quickstart/" class="inline-flex items-center gap-2 px-6 py-3 bg-emerald-600 text-white font-semibold rounded-lg hover:bg-emerald-700 transition-all hover:no-underline" >クイックスタート</a > <a href="/ja/python/overview/" class="inline-flex items-center gap-2 px-6 py-3 border border-[var(--border)] text-[var(--text)] font-semibold rounded-lg hover:bg-[var(--bg-alt)] transition-all hover:no-underline" >完全ドキュメント</a > </div> </div> </section> </main> <Footer locale={locale} /> </body> </html>}