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
Metadata
Release files for pipecatcloud 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pipecatcloud-1.3.0.tar.gz | 365.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pipecatcloud-1.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 486.3 kB
Release files / pipecatcloud-1.3.0.tar.gz
| Download URL | pipecatcloud-1.3.0.tar.gz |
|---|---|
| Size | 365.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3d852704bd53ee283e0f9c2df1b3a2a37d6d9f01c723b5f753f762b0e4aac9e9
|
|
BLAKE2b-256 checksum How to use checksums |
9e831d0739ef02652d16d050850e6037728094ae347931f0e94ddea426a307d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency logRelease files / pipecatcloud-1.3.0-py3-none-any.whl
| Download URL | pipecatcloud-1.3.0-py3-none-any.whl |
|---|---|
| Size | 120.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8f2eeb788b23f3e62df49ac013f2109b9e2d059b05cec4de04e6504da6c15b89
|
|
BLAKE2b-256 checksum How to use checksums |
e7fa510293c0688a38e779f0feb75b8b04e2c1916f20f32615be459af0ac2c54
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency log
