Metadata-Version: 2.4
Name: ovos-stt-plugin-vosk
Version: 0.2.8a1
Summary: A vosk stt plugin for OpenVoiceOS
Author-email: JarbasAi <jarbasai@mailfence.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/OpenVoiceOS/ovos-stt-plugin-vosk
Keywords: mycroft,ovos,plugin,stt
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ovos-plugin-manager<3.0.0,>=2.1.1
Requires-Dist: ovos-utils<1.0.0,>=0.8.4
Requires-Dist: vosk
Provides-Extra: test
Requires-Dist: ovoscope>=0.19.0a1; extra == "test"
Requires-Dist: ovos-dinkum-listener; extra == "test"
Requires-Dist: pytest<9; extra == "test"
Requires-Dist: pytest-timeout>=2.0.0; extra == "test"
Dynamic: license-file

## Description

Mycroft STT plugin for [Vosk](https://alphacephei.com/vosk/)

## Install

`pip install ovos-stt-plugin-vosk`

You can download official models from [alphacephei](https://alphacephei.com/vosk/models)


## Configuration

You need to download a kaldi model or provide a direct download url

```json
  "stt": {
    "module": "ovos-stt-plugin-vosk",
    "ovos-stt-plugin-vosk": {
        "model": "/path/to/unzipped/model/folder"
    }
  }
 
```

### Advanced configuration


```json
  "stt": {
    "module": "ovos-stt-plugin-vosk-streaming",
    "ovos-stt-plugin-vosk-streaming": {
        "model": "http://alphacephei.com/vosk/models/vosk-model-small-en-us-0.15.zip",
        "verbose": true
    },
    "ovos-stt-plugin-vosk": {
        "model": "http://alphacephei.com/vosk/models/vosk-model-small-en-us-0.15.zip"
    }
  }
 
```


`ovos-stt-plugin-vosk` - regular STT, transcription happens after recording finishes

`ovos-stt-plugin-vosk-streaming` - streaming STT, transcription happens real time

`verbose` - print partial transcriptions

`model` - full path or direct download url for model

`lang` - optional, if `model` not provided will download default small model (if it exists)


## Docker

This plugin can be used together with [ovos-stt-http-server](https://github.com/OpenVoiceOS/ovos-stt-http-server) 

```bash
docker run -p 8080:8080 ghcr.io/openvoiceos/vosk-stt-http-server:master
```
