pipecat-pyai
PyAI Hear (speech-to-text) and Speak (text-to-speech) services for Pipecat, maintained by PyAI.
Use this package when you want to own the Pipecat transport, frame pipeline, LLM, tools, and turn policy. Use PyAI Omni when you want one managed speech-to-speech agent instead.
pip install pipecat-pyai==0.1.0
Requires Python 3.11 or newer.
Usage
from pipecat_pyai import PyAISTTService, PyAITTSService
stt = PyAISTTService(language="en") # PyAI Hear (streaming STT)
tts = PyAITTSService(voice="stock_emma_en_gb") # PyAI Speak (TTS)
Set your key once: export PYAI_API_KEY=pyai_live_... (or pass api_key=). The
key needs the hear:stream, speak:synthesize scopes. List voices at
GET https://api.pyai.com/v1/voices. See the
integration status and comparison for the
current public guide link, production notes, and release status. The source
distribution also includes examples/bot.py.
PyAISTTService
WebSocket streaming STT (subclass of Pipecat's WebsocketSTTService). Sends
pipeline audio to the PyAI Hear socket and pushes InterimTranscriptionFrame
(PyAI partial/speech_final) and TranscriptionFrame (PyAI corrected
final). Args: api_key, base_url, model (pyai-hear), language,
sample_rate. The service sends the canonical commit control when Pipecat's
VAD reports the end of speech and marks the corrected transcript finalized.
PyAITTSService
Chunked TTS (subclass of TTSService). Requests response_format: pcm at the
pipeline's output sample rate and pushes TTSAudioRawFrames as the audio
streams. Args: voice (required), api_key, base_url, model (pyai-speak),
sample_rate, aiohttp_session. Use a streaming-capable voice id.
Notes
- Billing/limits follow your PyAI key (
hear.minutes,speak.minutes); a streaming STT session counts against your key's realtime concurrency. - Built on the official PyAI Python SDK (
pyai-sdk). - Hear streaming is English-only. Use Omni for multilingual realtime agents.
- Pipecat Cloud, transports, your LLM, and worker hosting are separate from PyAI Hear and Speak metering.
- For a fully managed agent, including turn-taking, reasoning, tools, caller continuity when enabled on an Agent profile and a caller key is available, and optional telephony, use PyAI Omni instead.
- Licensed under Apache-2.0. The source is included in the wheel and source distribution.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pipecat_pyai-0.1.0.tar.gz.
File metadata
- Download URL: pipecat_pyai-0.1.0.tar.gz
- Upload date:
- Size: 15.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
96b479dcd6f10eb947cd60e0a68b9ce9f14b17aed38921db210fb5c1047cee4a
|
|
| MD5 |
3c70c1146e57d7281850c0ce34bc3e32
|
|
| BLAKE2b-256 |
ac607e72f840e32aa0a9fff10417e99a168c2f662756e410353d6ea22fc188c6
|
Provenance
The following attestation bundles were made for pipecat_pyai-0.1.0.tar.gz:
Publisher:
publish-pipecat-plugin-pypi.yml on atomsai/pyai-platform-backend
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pipecat_pyai-0.1.0.tar.gz -
Subject digest:
96b479dcd6f10eb947cd60e0a68b9ce9f14b17aed38921db210fb5c1047cee4a - Sigstore transparency entry: 2498566881
- Sigstore integration time:
-
Permalink:
atomsai/pyai-platform-backend@89966001cb589e87000e4463379f8bc78b3597ca -
Branch / Tag:
refs/heads/main - Owner: https://github.com/atomsai
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pipecat-plugin-pypi.yml@89966001cb589e87000e4463379f8bc78b3597ca -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file pipecat_pyai-0.1.0-py3-none-any.whl.
File metadata
- Download URL: pipecat_pyai-0.1.0-py3-none-any.whl
- Upload date:
- Size: 12.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c674e112d92e344f586fccb6f286ccefe78a62e1baca7e9fb6254ad9a70b4763
|
|
| MD5 |
6443ac29816e77346f4a27b8e656f27e
|
|
| BLAKE2b-256 |
5ebaba4387e908733eb343cee832f58bc972cda092dd64da410f1e04cb2cba11
|
Provenance
The following attestation bundles were made for pipecat_pyai-0.1.0-py3-none-any.whl:
Publisher:
publish-pipecat-plugin-pypi.yml on atomsai/pyai-platform-backend
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pipecat_pyai-0.1.0-py3-none-any.whl -
Subject digest:
c674e112d92e344f586fccb6f286ccefe78a62e1baca7e9fb6254ad9a70b4763 - Sigstore transparency entry: 2498566883
- Sigstore integration time:
-
Permalink:
atomsai/pyai-platform-backend@89966001cb589e87000e4463379f8bc78b3597ca -
Branch / Tag:
refs/heads/main - Owner: https://github.com/atomsai
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pipecat-plugin-pypi.yml@89966001cb589e87000e4463379f8bc78b3597ca -
Trigger Event:
workflow_dispatch
-
Statement type:
