pipecat cloud

Docs PyPI

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

  1. Create an account at Pipecat Cloud

  2. Login to your account pipecat cloud auth login

  3. Generate secrets pipecat cloud secrets set

  4. 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

  1. Clone the repository and navigate to it:

    git clone https://github.com/daily-co/pipecat-cloud.git
cd pipecat-cloud

  2. Install development and testing dependencies:

    uv sync --group dev

  3. 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

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

Owner

PyPI data
Data sourced directly from PyPI's database.

License

BSD 2-Clause License

Requires

Python >=3.11

Provides Extra

pipecat

Tags

pipecat pipecat-ai voice ai llm

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pipecatcloud-1.2.0.tar.gz (337.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pipecatcloud-1.2.0-py3-none-any.whl (117.3 kB view details)

Uploaded Python 3

File details

Details for the file pipecatcloud-1.2.0.tar.gz.

File metadata

  • Download URL: pipecatcloud-1.2.0.tar.gz
  • Upload date:
  • Size: 337.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pipecatcloud-1.2.0.tar.gz
Algorithm Hash digest
SHA256 f7fc5deedc12a8df4e98e127f1537b72e00710364f4dffc221b6c4baa3a51eb7
MD5 f4b32cdb6a0c8a674da998a2ff0a7c4c
BLAKE2b-256 7edfe129eee6517df8b570c229f6e5030fa671ef4b7d85acdf0d0c3c785d4380

See more details on using hashes here.

Provenance

The following attestation bundles were made for pipecatcloud-1.2.0.tar.gz:

Publisher: publish-pypi.yml on daily-co/pipecat-cloud

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pipecatcloud-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: pipecatcloud-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 117.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pipecatcloud-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 64af53d389d8fb9809cb41e85245af097de3c107b285930c0614d28a00cd44f8
MD5 da88670e5eacc87e33a5135856e1c702
BLAKE2b-256 9d492fa5cdff1978a326e76a483fd186861ba4f6eff6a3658dea38352f172695

See more details on using hashes here.

Provenance

The following attestation bundles were made for pipecatcloud-1.2.0-py3-none-any.whl:

Publisher: publish-pypi.yml on daily-co/pipecat-cloud

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 files

1.1.0

2 files

1.0.1

2 files

1.0.0

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.0

2 files

0.5.0

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.20

2 files

0.2.19

2 files

0.2.18

2 files

0.2.17

2 files

0.2.16

2 files

0.2.15

2 files

0.2.14

2 files

0.2.13

2 files

0.2.12

2 files

0.2.11

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

0.0.11

2 files

Yanked

0.0.10

2 files

Yanked reason: Error in github action

0.0.9

2 files

0.0.8

2 files

0.0.6

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page