Skip to main content
Create a new Pipecat project interactively with guided setup for bot type, transport, AI services, and deployment options. Usage:
pipecat init [OPTIONS]
Options:
--output / -o
string
Output directory where files will be saved. Defaults to current directory.

Interactive Setup

The CLI guides you through selecting:
  • Bot type and client framework - Phone, web (Next.js, Vite, Vanilla JS), or mobile
  • Transport provider - Daily, Twilio, Telnyx, Plivo, Exotel
  • Pipeline mode - Cascade or Realtime
  • AI services - STT, LLM, and TTS providers
  • Optional features - Additional capabilities for your bot
  • Deployment target - Local development or Pipecat Cloud

Examples

Basic Usage

# Initialize in current directory
pipecat init

Specify Output Directory

# Initialize in a specific directory
pipecat init --output my-bot

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
I