Quickstart

Prerequisites

# Install the Pipecat CLI
uv tool install pipecat-ai-cli

# Scaffold the quickstart project
pipecat init

The CLI will guide you through the setup. Choose the following options:

cd my-voice-app/bot
cp env.example .env       # add your API keys
uv sync
uv run bot.py

The bot starts at http://localhost:7860.

cd ../client
npm install
npm run dev

Open http://localhost:5173, click Connect, allow microphone access, and start talking.

First run note: The initial startup may take ~20 seconds as Pipecat downloads required models and imports. Subsequent runs will be much faster.

🎉 Success! Your bot is running locally. Now let’s deploy it to production so others can use it.