Pipecat Cloud
Python module and CLI for interacting with Pipecat Cloud.
Requirements
- Python 3.11+
- Docker and a Docker repository (e.g. Docker Hub)
- Active Pipecat Cloud account
Documentation
Documentation for Pipecat Cloud is available here.
Installation
The Pipecat Cloud CLI ships as part of the Pipecat CLI — its commands are available under pipecat cloud. Install the Pipecat CLI:
uv tool install pipecat-ai-cli
pipecat cloud --help
pipecat cloud auth login
! All CLI commands have a --help flag that will display the command usage and options.
To use Pipecat Cloud programmatically (without the CLI), install the package directly with uv add pipecatcloud and see Usage in Python scripts.
Usage
-
Create an account at Pipecat Cloud
-
Login to your account
pipecat cloud auth login -
Generate secrets
pipecat cloud secrets set -
Build and deploy your agent
pipecat cloud deploy
Usage in Python scripts
If want to programmatically start an agent within a Python script, you can use the pipecatcloud.session module.
from pipecatcloud.session import Session
from pipecatcloud.exception import AgentStartError
import asyncio
async def main():
session = Session(
agent_name="your-agent-name",
api_key="pk_...",
)
try:
await session.start()
except AgentStartError as e:
print(e)
except Exception as e:
raise (e)
if __name__ == "__main__":
asyncio.run(main())
Troubleshooting
SSL certificate errors on macOS
If pipecat cloud auth login fails with an SSL certificate verification error, your Python
installation may not have access to the macOS system certificate store. This is
common with Python installed via pyenv, conda, or the python.org installer.
To diagnose:
import ssl, sys, os
print(ssl.get_default_verify_paths())
print(os.path.realpath(sys.executable))
To fix, install certifi and point Python to its certificates:
pip install certifi
export SSL_CERT_FILE=$(python -c "import certifi; print(certifi.where())")
For the python.org installer, you can also run the bundled
Install Certificates.command script found in /Applications/Python X.Y/.
🛠️ Contributing
Setup Steps
-
Clone the repository and navigate to it:
git clone https://github.com/daily-co/pipecat-cloud.git cd pipecat-cloud
-
Install development and testing dependencies:
uv sync --group dev
-
Install the git pre-commit hooks:
uv run pre-commit install
Running tests
To run all tests, from the root directory:
uv run pytest
Run a specific test suite:
uv run pytest tests/test_name.py
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 pipecatcloud-1.1.0.tar.gz.
File metadata
- Download URL: pipecatcloud-1.1.0.tar.gz
- Upload date:
- Size: 294.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
71650325b077a81f1cf955ab69e2b33bf4a96cb6a1509a934c8b19bfe0eb8d83
|
|
| MD5 |
79986d6ec3cbc2c2249ca076300c7dc9
|
|
| BLAKE2b-256 |
4bf211e0917531fb36bc0112a2d79fd80445710bc189c9b34219fa1b1a7738a2
|
Provenance
The following attestation bundles were made for pipecatcloud-1.1.0.tar.gz:
Publisher:
publish-pypi.yml on daily-co/pipecat-cloud
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pipecatcloud-1.1.0.tar.gz -
Subject digest:
71650325b077a81f1cf955ab69e2b33bf4a96cb6a1509a934c8b19bfe0eb8d83 - Sigstore transparency entry: 2348106048
- Sigstore integration time:
-
Permalink:
daily-co/pipecat-cloud@b3b9ce3b9c0e77a3605b5edf77802a4be451ab79 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/daily-co
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@b3b9ce3b9c0e77a3605b5edf77802a4be451ab79 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file pipecatcloud-1.1.0-py3-none-any.whl.
File metadata
- Download URL: pipecatcloud-1.1.0-py3-none-any.whl
- Upload date:
- Size: 89.0 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 |
bcf4cfa76972fbcca9b3129f3a91b8a44e0f11b3bdea5870d2c5c495300576f9
|
|
| MD5 |
be55478fe8c4fe7ef7e06a3ba6009b59
|
|
| BLAKE2b-256 |
1cea35e0e09481f542a419f26b47aa9d84e8ae7f7c7e2bec1355d30b1ea6e754
|
Provenance
The following attestation bundles were made for pipecatcloud-1.1.0-py3-none-any.whl:
Publisher:
publish-pypi.yml on daily-co/pipecat-cloud
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pipecatcloud-1.1.0-py3-none-any.whl -
Subject digest:
bcf4cfa76972fbcca9b3129f3a91b8a44e0f11b3bdea5870d2c5c495300576f9 - Sigstore transparency entry: 2348106319
- Sigstore integration time:
-
Permalink:
daily-co/pipecat-cloud@b3b9ce3b9c0e77a3605b5edf77802a4be451ab79 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/daily-co
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@b3b9ce3b9c0e77a3605b5edf77802a4be451ab79 -
Trigger Event:
workflow_dispatch
-
Statement type:
