pipecat-config-validator

name: pipecat-config-validator description: "Validate PipeCat voice agent configuration and API connectivity. Use when: (1) Starting a new development session, (2) Debugging runtime connection failures, (3) Verifying environment setup before testing, (4) Checking API key validity, (5) Estimating cost per minute for current stack"

PipeCat Config Validator

Validates all required environment variables, tests API connectivity, and reports configuration issues with fix instructions.

Commands

• /validate-config — Run full configuration validation
• /validate-config --quick — Check env vars only (no API calls)
• /validate-config --costs — Show cost breakdown per minute

Reference Files

• references/config-schema.md — Required environment variables and validation rules

Validation Workflow

1. Environment Variables Check

Validates all required API keys and configuration values exist:

Required (Core Stack):

Required (Transport):

Required (Database):

2. API Connectivity Tests

For each service, validates the API key works:

• AssemblyAI: Test /v2/transcript endpoint
• Anthropic: Test /v1/messages with minimal prompt
• ElevenLabs: Test /v1/voices endpoint
• Daily.co: Test /v1/rooms endpoint
• Twilio: Test account info endpoint
• Supabase: Test database connection

3. Database Schema Validation

Checks required tables exist:

• leads — Lead data
• call_learnings — Call outcomes
• prompt_versions — Prompt version control
• conversation_transcripts — Call transcripts

4. Cost Estimation

Calculates cost per minute based on current service selection:

Usage Examples

Full Validation

User: /validate-config
Claude: Running full configuration validation...

Environment Variables: 10/10 configured
API Connectivity:
  [PASS] AssemblyAI - Connected (Universal-2 model)
  [PASS] Anthropic - Connected (claude-opus-4-5-20251101)
  [PASS] ElevenLabs - Connected (voice: Andrew Clone)
  [PASS] Daily.co - Connected
  [PASS] Twilio - Connected (+1-555-123-4567)
  [PASS] Supabase - Connected

Database Schema:
  [PASS] leads (1,234 records)
  [PASS] call_learnings (567 records)
  [PASS] prompt_versions (12 versions)

Estimated cost: $0.075/min

All checks passed. Ready to make calls.

Quick Check (No API Calls)

User: /validate-config --quick
Claude: Checking environment variables...

Core Stack:
  [PASS] ASSEMBLYAI_API_KEY (length: 40)
  [PASS] ANTHROPIC_API_KEY (length: 64)
  [PASS] ELEVENLABS_API_KEY (length: 32)
  [PASS] ELEVENLABS_VOICE_ID (length: 24)

Transport:
  [PASS] DAILY_API_KEY
  [PASS] TWILIO_ACCOUNT_SID
  [PASS] TWILIO_AUTH_TOKEN
  [PASS] TWILIO_PHONE_NUMBER

Database:
  [PASS] SUPABASE_URL
  [PASS] SUPABASE_KEY

10/10 environment variables configured.
Run /validate-config (without --quick) to test API connectivity.

Missing Configuration

User: /validate-config
Claude: Running full configuration validation...

Environment Variables: 8/10 configured
  [FAIL] ELEVENLABS_VOICE_ID - Not set
  [FAIL] DAILY_API_KEY - Not set

Fix instructions:
1. ELEVENLABS_VOICE_ID: Get from https://elevenlabs.io/voice-lab
   - Create or select a voice, copy the Voice ID
2. DAILY_API_KEY: Get from https://dashboard.daily.co/developers
   - Create an API key with room creation permissions

Add these to your .env file and run /validate-config again.

Error Handling

Common issues and resolutions:

Automation Script

Run scripts/validate_config.py directly for CI/CD integration:

python skills/pipecat-config-validator/scripts/validate_config.py
python skills/pipecat-config-validator/scripts/validate_config.py --quick
python skills/pipecat-config-validator/scripts/validate_config.py --json  # Machine-readable output

Exit codes:

• 0: All checks passed
• 1: Missing environment variables
• 2: API connectivity failures
• 3: Database schema issues