# 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": ["search", "fetch"] },
      "a2a":    { "agents": ["planner"] },
      "vector": { "provider": "pinecone" }
    }

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 | 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 →
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