---
id: pyannoteai-sdk
version: "0.4.0"
license: unclear
license_treatment: unclear
maintenance: aging
---

# pyannoteai-sdk — Official pyannoteAI Python SDK

License: unclear · Maintenance: aging · Downloads: 969.1K/mo

## What it is and what it does

This is the official Python client for pyannoteAI, a hosted audio analysis service. It wraps HTTP calls to upload audio files, submit jobs for speaker diarization (identifying who spoke when), speaker identification (matching speakers to known voiceprints), and speech-to-text orchestration (combining diarization with transcription to produce speaker-attributed transcripts). All processing happens on pyannoteAI's servers; the SDK handles authentication, job submission, polling, and result retrieval.

The package depends only on requests and requires Python 3.10+. It is designed for developers integrating speaker analysis into applications without running local models. Typical workflows involve uploading audio, submitting a job, and retrieving structured output containing speaker segments, voiceprints, or transcriptions. The package is aging (last release 212 days ago) with no visible repository or documentation links in its metadata, raising questions about ongoing support.

Use it for:

- Analyze recorded conversations to identify speaker boundaries and attribute speech segments to individuals.
- Build speaker identification systems by creating voiceprints from reference audio and matching them against new recordings.
- Generate speaker-attributed transcripts by combining diarization with speech-to-text in a single orchestrated job.
- Integrate speaker analysis into customer service or meeting transcription workflows without maintaining local ML models.
- Track known speakers (e.g., team members, hosts) across multiple audio files using stored voiceprints.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Client library for pyannoteAI's speaker diarization, speaker identification, and speech-to-text orchestration services via REST API.

Yes, if you need speaker diarization or identification and are willing to use a hosted service. The SDK is straightforward and has low install friction. However, verify the license terms before use, and be aware the package is aging with no visible repository or documentation—assess whether you're comfortable relying on a service with limited visible maintenance signals. Pricing and service guarantees should be confirmed with pyannoteAI directly.

## Install

pip install pyannoteai-sdk
uv add pyannoteai-sdk
poetry add pyannoteai-sdk

## Installing pyannoteai-sdk

Before you install: Low install friction with a single runtime dependency (requests). Package is aging—last release was 212 days ago—but no repository metadata is available to assess ongoing maintenance or community activity.

License in practice: License status is unclear; no SPDX identifier or raw license text is available. Verify the actual license terms before use in proprietary or copyleft-sensitive projects.

Quickstart:

pip install pyannoteai-sdk

from pyannoteai.sdk import Client
client = Client("your-api-key")
media_url = client.upload('/path/to/conversation.wav')
job_id = client.diarize(media_url)
diarization = client.retrieve(job_id)

Requires Python 3.10 or later; also requires an active pyannoteAI account and API key from dashboard.pyannote.ai.

Verify before relying:

- Whether the package is actively maintained or if the aging status reflects planned stability rather than abandonment.
- What the actual license terms are (SPDX and raw license text are both absent from metadata).
- Whether repository links, documentation, and homepage are intentionally absent or a metadata gap.
- Pricing, rate limits, and service availability guarantees for the pyannoteAI backend.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 969.1K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

speaker diarization api client, speaker identification voiceprint, speech transcription orchestration, audio analysis api sdk, speaker tracking identification, diarization as a service, voice attribution transcription, audio-analysis, speaker-diarization, api-client

[View on SkillFed](https://skillfed.io/packages/pyannoteai-sdk) · [View on PyPI](https://pypi.org/project/pyannoteai-sdk/)