A standalone, stateless OpenAI Chat Completions test model for Vizier and other clients. It requires Node.js 22 or later and has no runtime dependencies.
git clone --branch 030-node-dummyplug-server https://github.com/vizier-lab/dummyplug.git
cd dummyplug
npm ci
npm testRequires Node.js 22 or later. npm test runs the server's Node.js test suite.
npm startThe server binds to 127.0.0.1:9998. Check that it is running with:
curl http://127.0.0.1:9998/healthzSet DUMMYPLUG_HOST or DUMMYPLUG_PORT to change the bind address or port.
Keep dummyplug running in one terminal. In a second terminal, start Vizier from its repository:
just runOpen http://localhost:9999, create the first account if needed, and create an agent with the
dummyplug (testing) provider and any model name. Vizier's default URL is
http://127.0.0.1:9998/v1, so no API key or extra provider configuration is needed. To use a
different address, set DUMMYPLUG_URL when starting Vizier or save a base_url under
Settings → Providers.
docker build -t dummyplug .
docker run --rm -p 9998:9998 dummyplugGET /healthzGET /v1/modelsPOST /v1/chat/completions, returning JSON or server-sent events whenstream: true
The server accepts any model string and does not require an API key. It preserves the legacy tools, context, exact tool name, JSON tool request, trailing tool-result echo, and lorem response behavior. A JSON tool request may add "say": "text", which is returned as the message text beside the tool call (a mid-turn message). pruned lists the tool results the request carried as Vizier pruning placeholders ([output pruned (<size>) - use recall_history("<id>") to recall]), one - <call_id> <id> <size> line each, or (nothing pruned). Responses report zero usage. Scenario injection, request capture, and test-control routes belong in the caller's test harness; this service has no persistent request state.