nuvox 0.1.0

Python SDK for the NuVox TTS evaluation API

NuVox Python SDK

Python client for the NuVox TTS evaluation API.

Install

pip install nuvox

Quick Start

from nuvox import NuVox

client = NuVox(api_key="nvx_your_key")

# Audio-only evaluation
result = client.evaluate.audio("speech.wav")
print(result.metrics.utmos.value)    # 4.15
print(result.metrics.snr.value)      # 64.3
print(result.metrics.nisqa.overall)  # 3.82

# Audio + transcript evaluation
result = client.evaluate.audio_text("speech.wav", "Hello, welcome to NuVox.")
print(result.metrics.wer.value)      # 0.05
print(result.metrics.bleu.value)     # 0.92

Metrics

Metric	Requires	Measures
UTMOS	Audio	Predicted naturalness MOS (1-5)
SNR	Audio	Signal-to-noise ratio (dB)
NISQA	Audio	Multi-dim quality: coloration, discontinuity, noisiness, loudness
Pitch Range	Audio	Monotone/robotic detection (Hz std)
WER	Audio+Text	Word error rate
CER	Audio+Text	Character error rate
BLEU	Audio+Text	N-gram overlap score
Semantic Similarity	Audio+Text	Meaning preservation
Speaking Rate	Audio+Text	Words per minute

Environment Variable

Instead of passing api_key, set NUVOX_API_KEY:

export NUVOX_API_KEY=nvx_your_key

client = NuVox()  # picks up from env

License

MIT