Finchvox - Voice AI Observability, Elevated.
Meet Finchvox, local session replay purpose-built for Voice AI apps.
Finchvox unifies conversation audio, logs, traces, and metrics in a single UI, highlighting voice-specific problems like interruptions and high user <-> bot latency. Finchvox is currently designed for local, development usage.
Visit Finchvox.dev to signup for our production-ready hosted and self-hosted options.
👇 Click the image for a short video:
Table of Contents
Prerequisites
- Python 3.11 or higher
- Pipecat 0.0.68 or higher
Installation
# uv
uv add finchvox "pipecat-ai[tracing]"
# Or with pip
pip install finchvox "pipecat-ai[tracing]"
Setup
- Add the following to the top of your bot (e.g.,
bot.py):
import finchvox
from finchvox import FinchvoxProcessor
finchvox.init(service_name="my-voice-app")
- Add
FinchvoxProcessorto your pipeline, ensuring it comes aftertransport.output():
pipeline = Pipeline([
# SST, LLM, TTS, etc. processors
transport.output(),
FinchvoxProcessor(), # Must come after transport.output()
context_aggregator.assistant(),
])
- Initialize your
PipelineTaskwith metrics, tracing and turn tracking enabled:
task = PipelineTask(
pipeline,
params=PipelineParams(enable_metrics=True),
enable_tracing=True,
enable_turn_tracking=True,
)
Configuration
The finchvox.init() function accepts the following optional parameters:
| Parameter | Default | Description |
|---|---|---|
endpoint |
"http://localhost:4317" |
Finchvox collector endpoint |
insecure |
True |
Use insecure gRPC connection (no TLS) |
capture_logs |
True |
Send logs to collector alongside traces |
log_modules |
None |
Additional module prefixes to capture (e.g., ["myapp"]) |
By default, logs from pipecat.*, finchvox.*, __main__, and any source files in your project directory are captured. Use log_modules to include additional third-party modules.
Usage - Finchvox server
uv run finchvox start
For the list of available options, run:
uv run finchvox --help
Troubleshooting
No spans being written
- Check collector is running: Look for "OTLP collector listening on port 4317" log message
- Verify client endpoint: Ensure Pipecat is configured to send to
http://localhost:4317
Telemetry
FinchVox collects minimal, anonymous usage telemetry to help improve the project. No personal data, IP addresses, or session content is collected.
What's collected:
- Event type (
server_start,session_ingest,session_view) - FinchVox version
- Operating system (macOS, Linux, or Windows)
- Timestamp
Disable telemetry:
finchvox start --telemetry false
Or set the environment variable:
export FINCHVOX_TELEMETRY=false
1 maintainer
Metadata
1 maintainer
Release files for finchvox 0.0.17
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| finchvox-0.0.17.tar.gz | 48.6 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| finchvox-0.0.17-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 48.9 MB
Release files / finchvox-0.0.17.tar.gz
| Download URL | finchvox-0.0.17.tar.gz |
|---|---|
| Size | 48.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c6622b1250e1127727971a4c7bbd48744447055f7117323f9a75bcb0ca7978df
|
|
BLAKE2b-256 checksum How to use checksums |
7b8b568299639d5a11b2813478d76594699cbd21d17d3222bbea64a1478fafb1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / finchvox-0.0.17-py3-none-any.whl
| Download URL | finchvox-0.0.17-py3-none-any.whl |
|---|---|
| Size | 293.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b23463deecb552a1c8b616beabfb4759be1eefc78b56296f643c1170e9c65579
|
|
BLAKE2b-256 checksum How to use checksums |
e51e3d0c7b5726d7717997f717be5f640a3aad5cad73076d280fccde89467abf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for finchvox 0.0.17
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
