# Cheetah Binding for Python
## Cheetah Speech-to-Text Engine
Made in Vancouver, Canada by [Picovoice](https://picovoice.ai)
Cheetah is an on-device streaming speech-to-text engine. Cheetah is:
- Private; All voice processing runs locally.
- [Accurate](https://picovoice.ai/docs/benchmark/stt/)
- [Compact and Computationally-Efficient](https://github.com/Picovoice/speech-to-text-benchmark#rtf)
- Cross-Platform:
- Linux (x86_64), macOS (x86_64, arm64), and Windows (x86_64, arm64)
- Android and iOS
- Chrome, Safari, Firefox, and Edge
- Raspberry Pi (3, 4, 5)
## Compatibility
- Python 3.9+
- Runs on Linux (x86_64), macOS (x86_64, arm64), Windows (x86_64, arm64), and Raspberry Pi (3, 4, 5).
## Installation
```console
pip3 install pvcheetah
```
## AccessKey
Cheetah requires a valid Picovoice `AccessKey` at initialization. `AccessKey` acts as your credentials when using Cheetah SDKs.
You can get your `AccessKey` for free. Make sure to keep your `AccessKey` secret.
Signup or Login to [Picovoice Console](https://console.picovoice.ai/) to get your `AccessKey`.
## Usage
Create an instance of the engine and transcribe audio:
```python
import pvcheetah
handle = pvcheetah.create(access_key='${ACCESS_KEY}')
def get_next_audio_frame():
pass
while True:
partial_transcript, is_endpoint = handle.process(get_next_audio_frame())
if is_endpoint:
final_transcript = handle.flush()
```
Replace `${ACCESS_KEY}` with yours obtained from [Picovoice Console](https://console.picovoice.ai/). When done be sure
to explicitly release the resources using `handle.delete()`.
### Language Model
The Cheetah Python SDK comes preloaded with a default English language model (`.pv` file).
Default models for other supported languages can be found in [lib/common](../../lib/common).
Create custom language models using the [Picovoice Console](https://console.picovoice.ai/). Here you can train
language models with custom vocabulary and boost words in the existing vocabulary.
Pass in the `.pv` file via the `model_path` argument:
```python
cheetah = pvcheetah.create(
access_key='${ACCESS_KEY}',
model_path='${MODEL_FILE_PATH}')
```
## Demos
[pvcheetahdemo](https://pypi.org/project/pvcheetahdemo/) provides command-line utilities for processing audio using
Cheetah.
Raw data
{
"_id": null,
"home_page": "https://github.com/Picovoice/cheetah",
"name": "pvcheetah",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "Speech-to-Text, Speech Recognition, Voice Recognition, ASR, Automatic Speech Recognition",
"author": "Picovoice",
"author_email": "hello@picovoice.ai",
"download_url": "https://files.pythonhosted.org/packages/29/4a/89f5b99d32e3d60bf9f0e258e1ce909c548273227b167945fea150d0083c/pvcheetah-2.1.2.tar.gz",
"platform": null,
"description": "# Cheetah Binding for Python\n\n## Cheetah Speech-to-Text Engine\n\nMade in Vancouver, Canada by [Picovoice](https://picovoice.ai)\n\nCheetah is an on-device streaming speech-to-text engine. Cheetah is:\n\n- Private; All voice processing runs locally.\n- [Accurate](https://picovoice.ai/docs/benchmark/stt/)\n- [Compact and Computationally-Efficient](https://github.com/Picovoice/speech-to-text-benchmark#rtf)\n- Cross-Platform:\n - Linux (x86_64), macOS (x86_64, arm64), and Windows (x86_64, arm64)\n - Android and iOS\n - Chrome, Safari, Firefox, and Edge\n - Raspberry Pi (3, 4, 5)\n\n## Compatibility\n\n- Python 3.9+\n- Runs on Linux (x86_64), macOS (x86_64, arm64), Windows (x86_64, arm64), and Raspberry Pi (3, 4, 5).\n\n## Installation\n\n```console\npip3 install pvcheetah\n```\n\n## AccessKey\n\nCheetah requires a valid Picovoice `AccessKey` at initialization. `AccessKey` acts as your credentials when using Cheetah SDKs.\nYou can get your `AccessKey` for free. Make sure to keep your `AccessKey` secret.\nSignup or Login to [Picovoice Console](https://console.picovoice.ai/) to get your `AccessKey`.\n\n## Usage\n\nCreate an instance of the engine and transcribe audio:\n\n```python\nimport pvcheetah\n\nhandle = pvcheetah.create(access_key='${ACCESS_KEY}')\n\ndef get_next_audio_frame():\n pass\n\nwhile True:\n partial_transcript, is_endpoint = handle.process(get_next_audio_frame())\n if is_endpoint:\n final_transcript = handle.flush()\n```\n\nReplace `${ACCESS_KEY}` with yours obtained from [Picovoice Console](https://console.picovoice.ai/). When done be sure\nto explicitly release the resources using `handle.delete()`.\n\n### Language Model\n\nThe Cheetah Python SDK comes preloaded with a default English language model (`.pv` file).\nDefault models for other supported languages can be found in [lib/common](../../lib/common).\n\nCreate custom language models using the [Picovoice Console](https://console.picovoice.ai/). Here you can train\nlanguage models with custom vocabulary and boost words in the existing vocabulary.\n\nPass in the `.pv` file via the `model_path` argument:\n```python\ncheetah = pvcheetah.create(\n access_key='${ACCESS_KEY}',\n model_path='${MODEL_FILE_PATH}')\n```\n\n## Demos\n\n[pvcheetahdemo](https://pypi.org/project/pvcheetahdemo/) provides command-line utilities for processing audio using\nCheetah.\n",
"bugtrack_url": null,
"license": null,
"summary": "Cheetah Speech-to-Text Engine.",
"version": "2.1.2",
"project_urls": {
"Homepage": "https://github.com/Picovoice/cheetah"
},
"split_keywords": [
"speech-to-text",
" speech recognition",
" voice recognition",
" asr",
" automatic speech recognition"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "07525910b4d9e6b97a5871ea02fbc6afe5467beb1aa1733c0975a4516631a3b2",
"md5": "6597070175497f2d5e299fa95fe77d8e",
"sha256": "2ae121c7a29cd7bdeea42716f93a1e3366852bba47c3565ea20489eb7cd2773d"
},
"downloads": -1,
"filename": "pvcheetah-2.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6597070175497f2d5e299fa95fe77d8e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 29588439,
"upload_time": "2025-02-05T23:42:34",
"upload_time_iso_8601": "2025-02-05T23:42:34.748499Z",
"url": "https://files.pythonhosted.org/packages/07/52/5910b4d9e6b97a5871ea02fbc6afe5467beb1aa1733c0975a4516631a3b2/pvcheetah-2.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "294a89f5b99d32e3d60bf9f0e258e1ce909c548273227b167945fea150d0083c",
"md5": "001371d57f53edac211f6022384c9f06",
"sha256": "262471292e2a0562eddf51a57c77ccb437d6a6efb11d4422006bdac5d50e4cb9"
},
"downloads": -1,
"filename": "pvcheetah-2.1.2.tar.gz",
"has_sig": false,
"md5_digest": "001371d57f53edac211f6022384c9f06",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 29581026,
"upload_time": "2025-02-05T23:42:40",
"upload_time_iso_8601": "2025-02-05T23:42:40.747129Z",
"url": "https://files.pythonhosted.org/packages/29/4a/89f5b99d32e3d60bf9f0e258e1ce909c548273227b167945fea150d0083c/pvcheetah-2.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-05 23:42:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Picovoice",
"github_project": "cheetah",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pvcheetah"
}
JSON
