# 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
--port PORT port number
--host HOST host
--lang LANG default language
--gradio flag to enable Gradio web UI
--cache flag to pre-cache examples in Gradio web UI
--title TITLE title for Gradio UI
--description DESCRIPTION Description for Gradio UI
--info INFO Text to display in Gradio UI
--badge BADGE URL of badge to show in Gradio UI
```
> Note: `ffmpeg` is required for Gradio
## 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-http-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": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "plugin STT OVOS OpenVoiceOS",
"author": "JarbasAi",
"author_email": "jarbasai@mailfence.com",
"download_url": "https://files.pythonhosted.org/packages/9b/55/175bb9179fe7801dc2e60804400b277c1251ef64cdf94167974484eca2ab/ovos-stt-http-server-0.0.2.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 --port PORT port number\n --host HOST host\n --lang LANG default language\n --gradio flag to enable Gradio web UI\n --cache flag to pre-cache examples in Gradio web UI\n --title TITLE title for Gradio UI\n --description DESCRIPTION Description for Gradio UI\n --info INFO Text to display in Gradio UI\n --badge BADGE URL of badge to show in Gradio UI\n```\n> Note: `ffmpeg` is required for Gradio\n\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-http-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",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "simple aiohttp server to host OpenVoiceOS stt plugins as a service",
"version": "0.0.2",
"project_urls": {
"Homepage": "https://github.com/OpenVoiceOS/ovos-stt-http-server"
},
"split_keywords": [
"plugin",
"stt",
"ovos",
"openvoiceos"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c600583476f3786e2a9d2c1bd456dc1e44b0ab83def94b9d69fb6317a9c80c3f",
"md5": "655f358351725d8184b22d9368d65196",
"sha256": "b2607c035eeb54518f5a11217efeb47074f9a271380c54a5465b95b99afe1e23"
},
"downloads": -1,
"filename": "ovos_stt_http_server-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "655f358351725d8184b22d9368d65196",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 522764,
"upload_time": "2023-06-26T22:13:04",
"upload_time_iso_8601": "2023-06-26T22:13:04.707056Z",
"url": "https://files.pythonhosted.org/packages/c6/00/583476f3786e2a9d2c1bd456dc1e44b0ab83def94b9d69fb6317a9c80c3f/ovos_stt_http_server-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9b55175bb9179fe7801dc2e60804400b277c1251ef64cdf94167974484eca2ab",
"md5": "e0481d3709006e761977203864eebc80",
"sha256": "8982b035c3dcaeb3bd46bd4f094e844a1dee5fdf64dd8e2e3c2146e1f4c72d3b"
},
"downloads": -1,
"filename": "ovos-stt-http-server-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "e0481d3709006e761977203864eebc80",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 523603,
"upload_time": "2023-06-26T22:13:06",
"upload_time_iso_8601": "2023-06-26T22:13:06.370434Z",
"url": "https://files.pythonhosted.org/packages/9b/55/175bb9179fe7801dc2e60804400b277c1251ef64cdf94167974484eca2ab/ovos-stt-http-server-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-26 22:13:06",
"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"
}