aimock Documentation

Complete mock infrastructure for AI application testing. One package, zero dependencies.

Quick Start

Mock LLM APIs

                Programmatic usage
                ts
              

import { LLMock } from "@copilotkit/aimock";

const mock = new LLMock();
await mock.start();

mock.onMessage("hello", { content: "Hi there!" });

Quick Start: LLM →

Mock your entire stack

                aimock.json config
                json
              

{
  "llm":    { "fixtures": "./fixtures/llm" },
  "mcp":    { "tools": [{ "name": "search", "result": "3 results" }] },
  "a2a":    { "agents": [{ "name": "planner" }] },
  "vector": { "collections": [{ "name": "docs", "dimension": 1536 }] }
}

Quick Start: full suite →

What's New

Framework Guides

Test your LangChain, CrewAI, PydanticAI, LlamaIndex, Mastra, ADK, or MAF agents

Guides →

Multimedia APIs

Image generation, text-to-speech, transcription, and video mocking

Docs →

AG-UI Protocol

Mock agent-to-UI event streams for CopilotKit frontends

Docs →

GitHub Action

One-line CI setup for mock-backed test suites

Setup →

Context Routing

Scope fixtures per integration with X-AIMock-Context header

Docs →

The Suite

Mock	What it does	Docs
LLM Providers	OpenAI, Claude, Gemini, Gemini Interactions, Bedrock, Azure, Vertex AI, Ollama, Cohere, OpenRouter	Docs →
Multimedia	Image generation, TTS, transcription, video	Docs →
MCP Protocol	Tools, resources, prompts, session management	Docs →
A2A Protocol	Agent cards, message routing, SSE streaming	Docs →
AG-UI Protocol	Event streams for CopilotKit frontends	Docs →
Vector DBs	Pinecone, Qdrant, ChromaDB	Docs →
Files	Upload, list, retrieve, download and delete, byte-exact	Docs →
Services	Search, rerank, moderation	Docs →

Framework Guides

LangChain · CrewAI · PydanticAI · LlamaIndex · Mastra · Google ADK · Microsoft Agent Framework

Switching from other tools?

MSW · VidaiMock · mock-llm · piyook/llm-mock · Python mocks · openai-responses · Mokksy