Cheetah Speech-to-Text
.NET Quick Start

Platforms

• Linux (x86_64)
• macOS (x86_64, arm64)
• Windows (x86_64, arm64)
• Raspberry Pi (3, 4, 5)

Requirements

• Picovoice Account & AccessKey

.NET Framework 4.6.1+ / .NET Standard 2.0+ / .NET Core 3.1+:

• Windows (x86_64)

.NET Core 2.0+ / .NET Core 3.1+:

• macOS (x86_64)

.NET 6.0+:

• macOS (arm64)
• Windows (arm64)
• Linux (x86_64)
• Raspberry Pi (3, 4, 5)

Picovoice Account & AccessKey

Signup or Login to Picovoice Console to get your AccessKey. Make sure to keep your AccessKey secret.

Quick Start

Setup

1. Install .NET.

2. Install the Cheetah Streaming Speech-to-Text NuGet package in Visual Studio or using the .NET CLI:

dotnet add package Picovoice.Cheetah

Usage

Create an instance of the engine:

using Pv;

const string accessKey = "${ACCESS_KEY}";

Cheetah cheetah = Cheetah.Create(accessKey);

Transcribe audio:

short[] GetNextAudioFrame()
{
    // .. get audioFrame
    return audioFrame;
}

string transcript = "";

while(true)
{
    CheetahTranscript transcriptObj = cheetah.Process(GetNextAudioFrame());
    transcript += transcriptObj.Transcript;

    if (transcriptObj.IsEndpoint) {
        CheetahTranscript finalTranscriptObj = cheetah.Flush();
        transcript += finalTranscriptObj.Transcript;
    }
}

Model File

The Cheetah Speech-to-Text .NET SDK comes preloaded with a default English language model (.pv file). Default models for other supported languages can be found in the Cheetah Speech-to-Text GitHub repository.

Create custom language models using the Picovoice Console. Here you can train language models with custom vocabulary and boost words in the existing vocabulary.

To switch from the default English model, pass in a .pv file to the .Create() constructor:

Cheetah cheetah = Cheetah.Create(accessKey, modelPath: "${MODEL_PATH}");

Demo

For the Cheetah Streaming Speech-to-Text .NET SDK, we offer demo applications that demonstrate how to use the Speech-to-Text engine on real-time audio streams (i.e. microphone input).

Setup

1. Clone the Cheetah Streaming Speech-to-Text repository from GitHub:

git clone --recurse-submodules https://github.com/Picovoice/cheetah.git

2. Build the demo:

cd cheetah/demo/dotnet/Cheetah
dotnet build -c MicDemo.Release

Usage

Use the --help flag to see the usage options for the demo:

dotnet run -c MicDemo.Release -- --help

Ensure you have a working microphone connected to your system and run the following command to perform live speech-to-text:

dotnet run -c MicDemo.Release -- --access_key ${ACCESS_KEY}

For more information on our Cheetah Streaming Speech-to-Text demos for .NET, head over to our GitHub repository.

Resources