CopilotKit/aimock

Mock everything your AI app talks to — LLM APIs, MCP, A2A, AG-UI, vector DBs, search. One package, one port, zero dependencies.

What it solves

AI アプリケーションのテストは、ライブの LLM API やその他の AI サービスに依存するため、費用が高く、遅く、決定論的でないことが多いです。aimock は包括的なモックインフラストラクチャを提供し、開発者がローカルでこれらのサービスをシミュレートできるようにし、実際の API キーやネットワーク呼び出し、ライブ本番 API のコストを排除します。

How it works

aimock はローカルサーバーとして、複数の AI プロバイダーの API インターフェースを模倣します。AI SDK（例: OpenAI）の BASE_URL を aimock サーバーに向けるだけで、アプリケーションは実際のプロバイダーではなくモックにリクエストを送ります。事前に定義されたリクエスト‑レスポンスのペアである「fixtures」を使用して決定論的な結果を返します。また、レコード＆リプレイモードを備えており、実際の API 呼び出しをプロキシし、将来の決定論的リプレイ用に fixtures として保存できます。

Who it’s for

AI エージェント、LLM を活用したアプリケーション、マルチモーダル AI ツールを構築する開発者向けで、実際の本番エンドポイントにアクセスせずに、信頼性が高く高速でコスト効果の高い方法でユニットテストやエンドツーエンドテストを実行できます。

Highlights

  • Broad Provider Support: OpenAI、Claude、Gemini、Bedrock、Azure、Vertex AI、Ollama など、13 社のプロバイダーの 15 種類の API インターフェースをモックします。
  • Multimodal Capabilities: 画像生成（DALL‑E、Imagen）、テキスト‑トゥ‑スピーチ、音声文字起こし、動画生成のモックをサポートします。
  • Protocol Mocking: LLM だけでなく、MCP ツール、A2A（Agent‑to‑Agent）プロトコル、AG‑UI イベントストリーム、ベクトルデータベース（Pinecone、Qdrant、ChromaDB）もモックします。
  • Deterministic Testing: タイミング感知のある録画‑再生機能とマルチターン会話マッチングを含みます。
  • Chaos Testing: 500 エラー、JSON の不正形式、ストリーム途中の切断をシミュレートし、アプリケーションのレジリエンスをテストできます。
  • Scaling & Integration: CI/CD 用の Docker/Helm チャート、Vitest/Jest プラグイン、GitHub Action を提供し、テストパイプラインへのシームレスな統合を実現します。