# OpenVoiceOS STT HTTP Server
Turn any OVOS STT plugin into a micro service!
## Install
`pip install ovos-stt-http-server`
## Companion plugin
Use in your voice assistant with OpenVoiceOS [companion plugin](https://github.com/OpenVoiceOS/ovos-stt-server-plugin)
## Configuration
the plugin is configured just like if it was running in the assistant, under mycroft.conf
eg
```
"stt": {
"module": "ovos-stt-plugin-deepgram",
"ovos-stt-plugin-deepgram": {"key": "xtimes40"}
}
```
## Usage
```bash
ovos-stt-server --help
usage: ovos-stt-server [-h] [--engine ENGINE] [--port PORT] [--host HOST]
options:
-h, --help show this help message and exit
--engine ENGINE stt plugin to be used
--lang-engine LANG_ENGINE
audio language detection plugin to be used (optional)
--port PORT port number
--host HOST host
--lang LANG default language supported by plugin (default comes from mycroft.conf)
--multi Load a plugin instance per language (force lang support, loads multiple plugins into memory)
--gradio Enable Gradio Web UI
--cache Cache models for Gradio demo
--title TITLE Title for webUI
--description DESCRIPTION
Text description to print in UI
--info INFO Text to display at end of UI
--badge BADGE URL of visitor badge
```
> Note: `ffmpeg` is required for Gradio
eg `ovos-stt-server --engine ovos-stt-plugin-fasterwhisper --lang-engine ovos-audio-transformer-plugin-fasterwhisper`
## Docker
you can create easily create a docker file to serve any plugin
```dockerfile
FROM python:3.7
RUN pip3 install ovos-stt-http-server==0.0.1
RUN pip3 install {PLUGIN_HERE}
ENTRYPOINT ovos-stt-server --engine {PLUGIN_HERE}
```
build it
```bash
docker build . -t my_ovos_stt_plugin
```
run it
```bash
docker run -p 8080:9666 my_ovos_stt_plugin
```
Each plugin can provide its own Dockerfile in its repository using ovos-stt-http-server
Raw data
{
"_id": null,
"home_page": "https://github.com/OpenVoiceOS/ovos-stt-http-server",
"name": "ovos-stt-http-server",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "plugin STT OVOS OpenVoiceOS",
"author": "JarbasAi",
"author_email": "jarbasai@mailfence.com",
"download_url": "https://files.pythonhosted.org/packages/f3/01/f47dfb55094ecd01840fe7f674efdfd71cc3645edc27e7534f36976b1202/ovos-stt-http-server-0.1.1.tar.gz",
"platform": null,
"description": "# OpenVoiceOS STT HTTP Server\n\nTurn any OVOS STT plugin into a micro service!\n\n## Install\n\n`pip install ovos-stt-http-server`\n\n## Companion plugin\n\nUse in your voice assistant with OpenVoiceOS [companion plugin](https://github.com/OpenVoiceOS/ovos-stt-server-plugin)\n\n## Configuration\n\nthe plugin is configured just like if it was running in the assistant, under mycroft.conf\n\neg\n```\n \"stt\": {\n \"module\": \"ovos-stt-plugin-deepgram\",\n \"ovos-stt-plugin-deepgram\": {\"key\": \"xtimes40\"}\n }\n```\n\n\n## Usage\n\n```bash\novos-stt-server --help\nusage: ovos-stt-server [-h] [--engine ENGINE] [--port PORT] [--host HOST]\n\noptions:\n -h, --help show this help message and exit\n --engine ENGINE stt plugin to be used\n --lang-engine LANG_ENGINE\n audio language detection plugin to be used (optional)\n --port PORT port number\n --host HOST host\n --lang LANG default language supported by plugin (default comes from mycroft.conf)\n --multi Load a plugin instance per language (force lang support, loads multiple plugins into memory)\n --gradio Enable Gradio Web UI\n --cache Cache models for Gradio demo\n --title TITLE Title for webUI\n --description DESCRIPTION\n Text description to print in UI\n --info INFO Text to display at end of UI\n --badge BADGE URL of visitor badge\n```\n> Note: `ffmpeg` is required for Gradio\n\neg `ovos-stt-server --engine ovos-stt-plugin-fasterwhisper --lang-engine ovos-audio-transformer-plugin-fasterwhisper`\n\n## Docker\n\nyou can create easily create a docker file to serve any plugin\n\n```dockerfile\nFROM python:3.7\n\nRUN pip3 install ovos-stt-http-server==0.0.1\n\nRUN pip3 install {PLUGIN_HERE}\n\nENTRYPOINT ovos-stt-server --engine {PLUGIN_HERE}\n```\n\nbuild it\n```bash\ndocker build . -t my_ovos_stt_plugin\n```\n\nrun it\n```bash\ndocker run -p 8080:9666 my_ovos_stt_plugin\n```\n\nEach plugin can provide its own Dockerfile in its repository using ovos-stt-http-server\n\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "simple aiohttp server to host OpenVoiceOS stt plugins as a service",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/OpenVoiceOS/ovos-stt-http-server"
},
"split_keywords": [
"plugin",
"stt",
"ovos",
"openvoiceos"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "16c1b8428cc61efbe066cbe940bc368c0703c88d86cb3a0680aeab672737eec3",
"md5": "239948491b522113160febff65394a45",
"sha256": "2f3b07e99bc1ee16ae59f45849b868969da34db86752dcb1a0ac5dc5e083e190"
},
"downloads": -1,
"filename": "ovos_stt_http_server-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "239948491b522113160febff65394a45",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 523227,
"upload_time": "2024-11-24T18:20:25",
"upload_time_iso_8601": "2024-11-24T18:20:25.285819Z",
"url": "https://files.pythonhosted.org/packages/16/c1/b8428cc61efbe066cbe940bc368c0703c88d86cb3a0680aeab672737eec3/ovos_stt_http_server-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f301f47dfb55094ecd01840fe7f674efdfd71cc3645edc27e7534f36976b1202",
"md5": "0d2d5411c72054b88403dbb057a2416b",
"sha256": "75e5b86e0ee3f67c6851d613facc71dcb85a2926ec5816683985e7e81bbcc754"
},
"downloads": -1,
"filename": "ovos-stt-http-server-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "0d2d5411c72054b88403dbb057a2416b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 524330,
"upload_time": "2024-11-24T18:20:27",
"upload_time_iso_8601": "2024-11-24T18:20:27.235184Z",
"url": "https://files.pythonhosted.org/packages/f3/01/f47dfb55094ecd01840fe7f674efdfd71cc3645edc27e7534f36976b1202/ovos-stt-http-server-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-24 18:20:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OpenVoiceOS",
"github_project": "ovos-stt-http-server",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ovos-stt-http-server"
}
JSON
