Finchvox is an open source observability tool for voice agents built with Pipecat. It replays a development session locally, combining the conversation audio with OpenTelemetry traces, logs, and metrics in one UI, and it highlights voice-specific problems such as interruptions and long user-to-bot latency that general-purpose OpenTelemetry tooling does not show. The current release targets local development, and a self-hosted production option is planned.
Integration is three steps in your bot: call finchvox.init(servicename=...), add FinchvoxProcessor to the pipeline after transport.output(), and enable metrics, tracing, and turn tracking on the PipelineTask. A start command runs an OTLP collector alongside the UI. init accepts endpoint, insecure, capturelogs, and log_modules options. Logs from pipecat., finchvox., main, and your project's source files are captured by default.
Features
- Session replay: conversation audio aligned with traces, logs, and metrics in a single timeline
- Voice-specific signals: surfaces interruptions and user-to-bot latency
- OpenTelemetry-based: ships traces and logs over OTLP gRPC to a local collector
- Pipeline processor: FinchvoxProcessor captures audio from the Pipecat pipeline
- Log capture: application and Pipecat logs sent to the collector, with extra module prefixes configurable
- Local server: a start command runs the collector and UI on your machine
- Telemetry control: minimal anonymous usage events that can be disabled
