Voxa.Speech.Kokoro 0.7.2-alpha

This is a prerelease version of Voxa.Speech.Kokoro.
dotnet add package Voxa.Speech.Kokoro --version 0.7.2-alpha
                    
NuGet\Install-Package Voxa.Speech.Kokoro -Version 0.7.2-alpha
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Voxa.Speech.Kokoro" Version="0.7.2-alpha" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Voxa.Speech.Kokoro" Version="0.7.2-alpha" />
                    
Directory.Packages.props
<PackageReference Include="Voxa.Speech.Kokoro" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Voxa.Speech.Kokoro --version 0.7.2-alpha
                    
#r "nuget: Voxa.Speech.Kokoro, 0.7.2-alpha"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Voxa.Speech.Kokoro@0.7.2-alpha
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Voxa.Speech.Kokoro&version=0.7.2-alpha&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Voxa.Speech.Kokoro&version=0.7.2-alpha&prerelease
                    
Install as a Cake Tool

Voxa.Speech.Kokoro

Local/offline high-quality text-to-speech for the Voxa pipeline using Kokoro-82M (Apache-2.0) on ONNX Runtime, in-process.

No API key. No network after the first-run model download. The quality tier of Voxa's local speech stack — speech that rivals commercial cloud voices, on your own CPU (see Voxa.Speech.Piper for the faster, lighter speed tier).

Usage

With the Voxa meta-package the descriptor is pre-registered — configuration is all you need:

{
  "Voxa": {
    "Tts": "Kokoro",
    "Kokoro": { "Voice": "af_heart", "Precision": "fp16" }
  }
}

À la carte:

services.AddVoxa(configuration, voxa => voxa.AddProvider(KokoroDescriptors.Tts));

How it works

Synthesis runs in-process on ONNX Runtime (already in Voxa's dependency tree via SileroVad) — model weights load once per process and are shared across connections. Only phonemization leaves the process: a stateless per-sentence espeak-ng CLI call (~10–30 ms), resolved from PATH or a pinned per-platform download. Output is fixed at 24 kHz — the same rate as the cloud TTS default, so swapping a cloud voice for Kokoro doesn't change the wire session at all.

Licensing note: espeak-ng is GPL-3.0 and stays behind a process boundary. This package links no GPL code and must never reference KokoroSharp (it bundles espeak-ng natives into consumer output). Enforced by a dependency-graph gate test, not by review.

Configuration (Voxa:Kokoro)

Key Default Notes
Voice af_heart Catalog: af_heart, af_bella, am_michael, bf_emma, bm_george
Precision fp16 fp32 (~330 MB), fp16 (~163 MB), int8 (~92 MB, fastest, CI default)
ModelPath / VoicePath Explicit paths; bypass catalog + cache
EspeakPath Explicit espeak-ng binary; else PATH, else pinned download
EspeakVoice inferred a* voices → en-us, b*en-gb
Speed 1.0 >1 faster speech; range (0, 3]
MaxConcurrentSyntheses 2 Process-wide cap on parallel ONNX runs

OutputSampleRate overrides are rejected at startup — Kokoro-82M is 24 kHz only.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Voxa.Speech.Kokoro:

Package Downloads
Voxa

Batteries-included Voxa package. One package reference: AddVoxa(cfg) + MapVoxaVoice("/voice").UseDefaults() gives a working voice bot with STT, TTS, VAD, and an OpenAI chat agent — no knowledge of frames required.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.7.2-alpha 98 7/10/2026
0.7.1-alpha 65 7/10/2026
0.7.0-alpha 69 7/10/2026
0.6.0-alpha 90 6/22/2026
0.5.0-alpha 68 6/13/2026