Falcon Speaker Diarization
Python Quick Start

Platforms

• Linux (x86_64)
• macOS (x86_64, arm64)
• Windows (x86_64, arm64)
• Raspberry Pi (3, 4, 5)

Requirements

• Picovoice Account & AccessKey
• Python 3.9+
• PIP

Picovoice Account & AccessKey

Signup or Login to Picovoice Console to get your AccessKey. Make sure to keep your AccessKey secret.

Quick Start

Setup

1. Install Python 3.

2. Install the pvfalcon Python package using PIP:

pip3 install pvfalcon

Usage

Create an instance of the engine and perform speaker diarization on an audio file:

import pvfalcon

falcon = pvfalcon.create(access_key="${ACCESS_KEY}")

segments = falcon.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)
    )

Perform speaker diarization on raw audio data (sample rate of 16 kHz, 16-bit linearly encoded and 1 channel):

def get_audio_data():
   # get audio data

segments = falcon.process(get_audio_data())
for segment in segments:
    print(
        "{speaker_tag=%d start_sec=%.2f end_sec=%.2f}"
        % (segment.speaker_tag, segment.start_sec, segment.end_sec)
    )

Free resources used by Falcon Speaker Diarization:

falcon.delete();

Segments

Falcon Speaker Diarization returns an array of segments. Each segment has the following properties:

• Start Time: Indicates when the segment started. Value is in seconds.
• End Time: Indicates when the segment ended. Value is in seconds.
• Speaker Tag: A non-negative integer identifying unique speakers.

Demo

For the Falcon Speaker Diarization Python SDK, we offer a demo applications that demonstrates how to use the Speaker Diarization engine on audio files.

Setup

Install the pvfalcondemo Python package using PIP:

pip3 install pvfalcondemo

This package installs command-line utilities for the Falcon Speaker Diarization Python demos.

Usage

Use the --help flag to see the usage options for the demo:

falcon_demo_file --help

Run the following command to perform speaker diarization on an audio file:

falcon_demo_file --access_key ${ACCESS_KEY} \
                  --audio_paths ${AUDIO_PATH1} ${AUDIO_PATH2} ...

For more information on our Falcon Speaker Diarization demos for Python, head over to our GitHub repository.

Resources