---
id: pipecatcloud
version: "1.1.0"
license: BSD 2-Clause License
license_treatment: permissive
maintenance: active
---

# pipecatcloud — Cloud hosting for Pipecat AI applications

License: permissive · Maintenance: active · Downloads: 85.7K/mo

## What it is and what it does

Pipecatcloud is a Python SDK and CLI for interacting with Pipecat Cloud, a managed hosting platform for Pipecat AI agents. It provides both command-line tools (installed via the Pipecat CLI) and a programmatic Python API for deploying, authenticating, and controlling voice and AI agents in the cloud.

The package wraps Pipecat Cloud's REST API and handles authentication, session management, and agent lifecycle operations. It depends on aiohttp, fastapi, uvicorn, and other async-capable libraries to support concurrent agent management. Typical workflows include logging in, managing secrets, deploying agents via Docker, and programmatically starting agents from Python scripts using the Session class.

Use it for:

- Deploy a voice AI agent to Pipecat Cloud and manage its lifecycle from a Python application.
- Authenticate with Pipecat Cloud and generate API credentials for agent deployment.
- Build a multi-agent orchestration system that starts and monitors Pipecat agents programmatically.
- Integrate Pipecat agent deployment into a CI/CD pipeline using the CLI.
- Troubleshoot agent startup failures and SSL certificate issues on local development machines.

## Worth the install?

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

Python module and CLI for deploying, managing, and programmatically controlling Pipecat AI agents on Pipecat Cloud.

Yes, if you are building or deploying Pipecat AI agents and want a Python-native way to manage them on Pipecat Cloud. The package is actively maintained, has low install friction, and is permissively licensed. Requires Python 3.11+, an active Pipecat Cloud account, and Docker for building agents. No known security vulnerabilities.

## Install

pip install pipecatcloud
uv add pipecatcloud
poetry add pipecatcloud

## Installing pipecatcloud

Before you install: Low install friction with a pure-Python wheel. Active maintenance status (released 2026-08-05, 9 days old). Requires Python 3.11+ and a Pipecat Cloud account; Docker is needed for building agents but not for the Python package itself.

License in practice: BSD 2-Clause License is permissive, allowing commercial and private use with minimal restrictions—suitable for most projects.

Quickstart:

pip install pipecatcloud

from pipecatcloud.session import Session
import asyncio

async def main():
    session = Session(agent_name="my-agent", api_key="pk_...")
    await session.start()

asyncio.run(main())

Requires Python 3.11+. Requires an active Pipecat Cloud account and API key. Docker is needed to build and deploy agents via CLI.

Verify before relying:

- Whether the package supports programmatic agent lifecycle management beyond start (e.g., stop, status, logs).
- Whether secrets management is available through the Python API or only via CLI.
- Performance characteristics and rate limits when managing multiple agents concurrently.

## Package facts

- License: BSD 2-Clause License (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 85.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pipecat cloud deployment, pipecat ai agent hosting, voice ai agent management, pipecat cli tool, deploy pipecat agents, pipecat cloud python sdk, ai agent orchestration, ai-agent-hosting, voice-ai, pipecat-ecosystem

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