liveflow 0.1.0

Real-time LiveKit agent visualizer — observe agent state, tool calls, and conversations without modifying your code.

liveflow

Real-time visualizer for LiveKit voice agents — see which agent is active, what tools are running, and follow conversations live. No changes to your agent code.

---

What is Liveflow?

Liveflow is a zero-instrumentation debugging companion for LiveKit Agents. It monkey-patches the LiveKit SDK's AgentSession to capture every event — state changes, tool calls, handoffs, transcripts — and streams them over a local WebSocket to the Liveflow VS Code extension, which renders a live dashboard with:

• Agent Graph — all agents as nodes, active agent highlighted, animated handoff transitions
• Tool Timeline — every @function_tool call with args, output, duration, and status
• Conversation Transcript — live user/agent speech with interim transcripts
• Chat Context Inspector — full LLM context window, system prompts, function calls, handoff markers

Install

pip install liveflow

Usage

Option 1 — VS Code Extension (recommended)

Install the Liveflow VS Code extension, open your agent project, and click Run with Liveflow in the editor title bar. The extension handles everything automatically — no terminal command needed.

Option 2 — Terminal

# Before
python agent.py dev

# After — drop-in replacement
liveflow agent.py dev

Your agent runs exactly as before. Liveflow captures everything transparently in the background and streams it to the VS Code dashboard.

How It Works

┌──────────────────────────┐   WebSocket    ┌──────────────────────┐
│  Liveflow Python Shim    │ ─────────────▶ │  VS Code Extension   │
│  • Patches AgentSession  │  JSON events   │  • ReactFlow graph   │
│  • Captures all events   │                │  • Tool timeline     │
│  • Local WS server       │                │  • Transcript view   │
└──────────────────────────┘                └──────────────────────┘
         ▲
         │  transparent monkey-patch
         │
┌──────────────────────────┐
│  Your agent.py           │  ← UNMODIFIED
│  (LiveKit Agents SDK)    │
└──────────────────────────┘

Source Code

github.com/21lakshh/Liveflow — contributions welcome!