Pipecat CLI

A complete toolkit for building, deploying, and monitoring Pipecat AI voice agents.

Scaffold new projects with pipecat init
Deploy to production with pipecat cloud
Monitor live bots with pipecat tail

Requirements

Python 3.10+

Installation

uv tool install pipecat-ai-cli

This installs the CLI globally. If you don't have uv, you can also use pipx install pipecat-ai-cli.

Tip: All commands can use either pipecat or the shorter pc alias.

Optional: Install Tail Dashboard

To use the pipecat tail monitoring dashboard, install with the tail extra:

uv tool install "pipecat-ai-cli[tail]"

Create a New Project

Create a new quickstart Pipecat project with default settings:

pipecat init quickstart

Or create a new Pipecat project interactively:

pipecat init

The CLI will guide you through selecting:

Bot type and client framework
Transport provider (Daily, Twilio, etc.)
Pipeline mode (Cascade or Realtime)
AI services (STT, LLM, TTS)
Optional features and deployment target

Generated Project Structure

mybot/
├── server/                  # Python bot server
│   ├── bot.py              # Main bot implementation
│   ├── pyproject.toml      # Python dependencies
│   ├── .env.example        # Environment variables template
│   ├── Dockerfile          # Container image (if cloud enabled)
│   └── pcc-deploy.toml     # Deployment config (if cloud enabled)
├── client/                  # Web client (if generated)
│   ├── src/
│   ├── package.json
│   └── ...
├── .gitignore
└── README.md                # Project setup instructions

Deploy to Pipecat Cloud

Deploy and manage your bot in production with Pipecat Cloud:

# Authenticate
pipecat cloud auth login

# Deploy
pipecat cloud deploy

# Manage deployments
pipecat cloud agent list
pipecat cloud agent logs <agent-name>

Cloud commands provide:

🔐 Authentication and credential management
🐳 Docker build and registry integration
🚀 One-command deployment
📊 Agent status and log monitoring
🔧 Runtime configuration management

Note: When you enable "Deploy to Pipecat Cloud" during project creation, the necessary deployment config files are automatically generated.

Learn more in the Pipecat Cloud documentation.

Monitor Your Bot

Use the built-in Tail dashboard to monitor your bot in real-time:

# Connect to local bot (default: ws://localhost:9292)
pipecat tail

# Connect to remote session
pipecat tail --url wss://your-bot.example.com

Note: The tail command requires the optional tail extra. Install with uv tool install "pipecat-ai-cli[tail]" if not already installed.

Tail provides:

📜 Real-time system logs
💬 Live conversation tracking
🔊 Audio level monitoring
📈 Service metrics and usage stats

📚 Next steps

See the Pipecat documentation for more about building bots
Learn how to extend the template using examples & recipes
Join our Discord to get help or provide feedback

Metadata

Release files for pipecat-ai-cli 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pipecat-ai-cli 1.3.0
File	Size	Uploaded
pipecat_ai_cli-1.3.0.tar.gz	394.9 kB	May 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pipecat-ai-cli 1.3.0
File	Interpreter	ABI	Platform	Reset
pipecat_ai_cli-1.3.0-py3-none-any.whl 113.5 kB May 29, 2026	Python 3	none	any	Details

Total release size: 508.4 kB

Release files / pipecat_ai_cli-1.3.0.tar.gz

Download URL	pipecat_ai_cli-1.3.0.tar.gz
Size	394.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`84a4cad4558436999c49406d34f036338a2fc884c69f48351395f6f971fa844e`
BLAKE2b-256 checksum How to use checksums	`bc76377c4ea99ac649cfe4d62c750c0ec14005b501bcc617dc09413b6485b71a`
Upload date	May 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pipecat-ai/pipecat-cli
Publishing commit: github.com/pipecat-ai/pipecat-cli/tree/1d4849b7ac8718bf742a1666eb665c325583bb8b

Workflow

Publishing configuration: github.com/pipecat-ai/pipecat-cli/blob/1d4849b7ac8718bf742a1666eb665c325583bb8b/.github/workflows/publish.yaml
Publishing logs: github.com/pipecat-ai/pipecat-cli/actions/runs/26639085810/attempts/1

Artifact

Subject: pipecat_ai_cli-1.3.0.tar.gz
SHA-256 checksum: 84a4cad4558436999c49406d34f036338a2fc884c69f48351395f6f971fa844e Verifying attestations

Release files / pipecat_ai_cli-1.3.0-py3-none-any.whl

Download URL	pipecat_ai_cli-1.3.0-py3-none-any.whl
Size	113.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ef831b170fc36dc9dcc5de34fb67a5ede2545ab34c055918e785480279c7083e`
BLAKE2b-256 checksum How to use checksums	`859fc87f56d5e71f32f42ca34451cc424c17da4ccab8a499624d499494dd3b13`
Upload date	May 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pipecat-ai/pipecat-cli
Publishing commit: github.com/pipecat-ai/pipecat-cli/tree/1d4849b7ac8718bf742a1666eb665c325583bb8b

Workflow

Publishing configuration: github.com/pipecat-ai/pipecat-cli/blob/1d4849b7ac8718bf742a1666eb665c325583bb8b/.github/workflows/publish.yaml
Publishing logs: github.com/pipecat-ai/pipecat-cli/actions/runs/26639085810/attempts/1

Artifact

Subject: pipecat_ai_cli-1.3.0-py3-none-any.whl
SHA-256 checksum: ef831b170fc36dc9dcc5de34fb67a5ede2545ab34c055918e785480279c7083e Verifying attestations