quangdang46/livekit_agent_simulator

livekit-agent-simulator

<div align="center" <img src="lksillustration.webp" alt="lks — livekit-agent-simulator: black-box LiveKit agent tests with WebRTC, Inbound, Outbound" width="720" </div

<div align="center"

[](https://opensource.org/licenses/MIT) [](https://github.com/quangdang46/livekitagentsimulator/actions/workflows/ci.yml) [](https://github.com/quangdang46/livekitagentsimulator/releases)

</div

Dial any LiveKit voice agent with an AI simulated caller — WebRTC room, inbound SIP, or outbound SIP — and keep a full forensic log. Standalone MCP server + CLI (lks). Black-box testing: no imports from the agent under test, no edits to its code or .env.

<div align="center" <h3Quick Install</h3

curl -fsSL "https://raw.githubusercontent.com/quangdang46/livekit_agent_simulator/main/install.sh" \
  | bash -s -- --verify

</div

Install via coding agent (copy-paste)

Paste into Claude Code, Cursor, Codex, AmpCode, Windsurf, or any coding agent from the repo you want to test:

Install and configure livekit-agent-simulator (CLI: lks) for this project by following the instructions here:
https://raw.githubusercontent.com/quangdang46/livekit_agent_simulator/main/docs/guide/installation.md

Target project root is this workspace. Use absolute --root paths. Install the portable CLI if missing, run lks init, help fill .agent-sim/config.yaml from my local env or ask me for LiveKit + active text-backend key (Gemini or OpenAI) + agent_name, ensure .agent-sim is gitignored, run preflight, and stop before execute if the voice agent worker is not running. Do not edit agent application source outside .agent-sim/.

Same idea, one line:

Install and configure livekit-agent-simulator by following: https://raw.githubusercontent.com/quangdang46/livekit_agent_simulator/main/docs/guide/installation.md

---

TL;DR

The Problem

Voice agents fail in ways unit tests never see: