Skip to main content

Start a Project

Initialize a project, then build with a coding agent or scaffold a bot

Run Behavioral Evals

Test your agents with scripted scenarios and an LLM judge

Deploy to Cloud

Push your bots to production with one command

​
Requirements

  • Python 3.11 or later

​
Installation

The CLI ships with pipecat-ai as the optional cli extra. Install it globally with uv: 
uv tool install "pipecat-ai[cli]"
Verify installation: 
pipecat --version
All commands can use either pipecat or the shorter pc alias.
This gives you the built-in pipecat init, pipecat create, and pipecat eval commands. The cloud command is provided by a separate package that you co-install with --with: 
# Add deploy commands
uv tool install "pipecat-ai[cli]" --with pipecatcloud

​
Commands

  • pipecat init - Initialize a new Pipecat project, the entry point for new projects (built in)
  • pipecat create - Scaffold a project directly, used by init and coding agents (built in)
  • pipecat eval - Run behavioral evals against your agents
  • pipecat cloud - Deploy and manage bots on Pipecat Cloud (requires pipecatcloud)

​
Getting Help

View help for any command: 
pipecat --help
pipecat init --help
pipecat create --help
pipecat eval --help
pipecat cloud --help

​
Next Steps

Build Your First Bot

Initialize your project and start building with pipecat init