OVOS Transcription Validator Plugin

This plugin is a utterance transformer for OVOS. It uses an OpenAI-compatible large language model (LLM) to check speech-to-text (STT) transcriptions before your voice assistant processes them.

The plugin filters out garbled, nonsensical, or incomplete utterances. This reduces confusion and improves the accuracy of downstream skills.

Features

• Validates transcriptions in multiple languages.
• Works with OpenAI-compatible LLMs (for example, the OpenAI API, Ollama, or a custom server).
• Filters out invalid utterances before the assistant processes them.
• Plays an error sound or shows a dialog when it rejects an utterance.
• Supports per-request configuration overrides.

How It Works

1. The plugin receives an STT transcription and a language code.
2. It sends a structured prompt with examples to the configured OpenAI-compatible LLM API.
3. The LLM answers True (valid) or False (invalid).
4. If the LLM answers False, the plugin cancels the utterance. It also triggers a dialog prompt or an error sound if you configure one.

Installation

pip install ovos-transcription-validator-plugin

Configuration

Add the plugin to the utterance_transformers section of your mycroft.conf.

By default, the plugin uses https://llama.smartgic.io/v1 with the qwen2.5:7b model and a placeholder API key sk-xxxx.

{
  "utterance_transformers": {
    "ovos-transcription-validator-plugin": {
      "api_url": "https://llama.smartgic.io/v1",
      "api_key": "sk-xxxx",
      "model": "qwen2.5:7b",
      "prompt_template_system": "/path/to/system_template.txt",
      "prompt_template_user": "/path/to/user_template.txt",
      "error_sound": true,
      "mode": "ignore"
    }
  }
}

Available Settings

Requirements & Notes

• You need an OpenAI-compatible LLM API endpoint, for example the OpenAI API, Ollama running locally, or another custom server.
• The model you configure must already be available on your chosen LLM server.
• The plugin adapts to different languages based on the LLM's capabilities and training.

Related Projects

• OpenVoiceOS — the org that maintains the OVOS core and the utterance transformer framework this plugin extends.

Feedback & Contributions

Found a bug or want to contribute? Open an issue or a pull request.