pvfalcon


Namepvfalcon JSON
Version 1.0.4 PyPI version JSON
download
home_pagehttps://github.com/Picovoice/falcon
SummaryFalcon Speaker Diarization Engine
upload_time2025-02-06 00:04:27
maintainerNone
docs_urlNone
authorPicovoice
requires_python>=3.9
licenseNone
keywords speaker diarization speaker identification voice identification
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Falcon Binding for Python

## Falcon Speaker Diarization Engine

Made in Vancouver, Canada by [Picovoice](https://picovoice.ai)

Falcon is an on-device speaker diarization engine. Falcon is:

- Private; All voice processing runs locally.
- Cross-Platform:
  - Linux (x86_64), macOS (x86_64, arm64), Windows (x86_64, arm64)
  - 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 pvfalcon
```

## AccessKey

Falcon requires a valid Picovoice `AccessKey` at initialization. `AccessKey` acts as your credentials when using Falcon 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 perform speaker diarization on an audio file:

```python
import pvfalcon

handle = pvfalcon.create(access_key='${ACCESS_KEY}')

segments = handle.process_file('${AUDIO_PATH}')
for segment in segments:
    print("{speaker tag=%d - start_sec=%.2f end_sec=%.2f}" 
          % (segment.speaker_tag, segment.start_sec, segment.end_sec))
```

Replace `${ACCESS_KEY}` with yours obtained from [Picovoice Console](https://console.picovoice.ai/) and
`${AUDIO_PATH}` to the path an audio file. Finally, when done be sure to explicitly release the resources using
`handle.delete()`.

## Demos

[pvfalcondemo](https://pypi.org/project/pvfalcondemo/) provides command-line utilities for processing audio using
Falcon.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/Picovoice/falcon",
    "name": "pvfalcon",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "Speaker Diarization, Speaker Identification, Voice Identification",
    "author": "Picovoice",
    "author_email": "hello@picovoice.ai",
    "download_url": "https://files.pythonhosted.org/packages/d4/43/9206e14145317a6e98c1707f57cf97045e5a989d54f37174c29124724d82/pvfalcon-1.0.4.tar.gz",
    "platform": null,
    "description": "# Falcon Binding for Python\n\n## Falcon Speaker Diarization Engine\n\nMade in Vancouver, Canada by [Picovoice](https://picovoice.ai)\n\nFalcon is an on-device speaker diarization engine. Falcon is:\n\n- Private; All voice processing runs locally.\n- Cross-Platform:\n  - Linux (x86_64), macOS (x86_64, arm64), Windows (x86_64, arm64)\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 pvfalcon\n```\n\n## AccessKey\n\nFalcon requires a valid Picovoice `AccessKey` at initialization. `AccessKey` acts as your credentials when using Falcon 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 perform speaker diarization on an audio file:\n\n```python\nimport pvfalcon\n\nhandle = pvfalcon.create(access_key='${ACCESS_KEY}')\n\nsegments = handle.process_file('${AUDIO_PATH}')\nfor segment in segments:\n    print(\"{speaker tag=%d - start_sec=%.2f end_sec=%.2f}\" \n          % (segment.speaker_tag, segment.start_sec, segment.end_sec))\n```\n\nReplace `${ACCESS_KEY}` with yours obtained from [Picovoice Console](https://console.picovoice.ai/) and\n`${AUDIO_PATH}` to the path an audio file. Finally, when done be sure to explicitly release the resources using\n`handle.delete()`.\n\n## Demos\n\n[pvfalcondemo](https://pypi.org/project/pvfalcondemo/) provides command-line utilities for processing audio using\nFalcon.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Falcon Speaker Diarization Engine",
    "version": "1.0.4",
    "project_urls": {
        "Homepage": "https://github.com/Picovoice/falcon"
    },
    "split_keywords": [
        "speaker diarization",
        " speaker identification",
        " voice identification"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b8bf3b33513f4de317777bce4edd1def670dcf17fdba885a84c07c6a4abd65a3",
                "md5": "9e426204b7ee5fc4ca56d045db6ecf3a",
                "sha256": "87f31a0d4687aea21e983122bfffe8df4fc071d8fd582057b018de85b542c9f3"
            },
            "downloads": -1,
            "filename": "pvfalcon-1.0.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9e426204b7ee5fc4ca56d045db6ecf3a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 14773355,
            "upload_time": "2025-02-06T00:04:22",
            "upload_time_iso_8601": "2025-02-06T00:04:22.325787Z",
            "url": "https://files.pythonhosted.org/packages/b8/bf/3b33513f4de317777bce4edd1def670dcf17fdba885a84c07c6a4abd65a3/pvfalcon-1.0.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d4439206e14145317a6e98c1707f57cf97045e5a989d54f37174c29124724d82",
                "md5": "b338bf187f568d400575bc1109110a5b",
                "sha256": "03dd39a6562f28af8b8c3b355db15f627a0f4809d93f3e936f8dc9f774aeab1e"
            },
            "downloads": -1,
            "filename": "pvfalcon-1.0.4.tar.gz",
            "has_sig": false,
            "md5_digest": "b338bf187f568d400575bc1109110a5b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 14768566,
            "upload_time": "2025-02-06T00:04:27",
            "upload_time_iso_8601": "2025-02-06T00:04:27.606946Z",
            "url": "https://files.pythonhosted.org/packages/d4/43/9206e14145317a6e98c1707f57cf97045e5a989d54f37174c29124724d82/pvfalcon-1.0.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-06 00:04:27",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Picovoice",
    "github_project": "falcon",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "pvfalcon"
}
        
Elapsed time: 0.41970s