elevenlabs-phone-reminder-lite

# 📞 AI Phone Reminder (Lite)

Build an AI assistant that can **call you on the phone** with natural voice conversations!

## 🎯 What You'll Build

- AI agent that makes outbound phone calls
- Natural conversation with voice cloning
- Multi-language support (including Chinese, Japanese, etc.)
- Real-time voice interaction (not pre-recorded!)

## 📋 Prerequisites

1. **ElevenLabs Account** (Creator plan or above)
   - [**👉 Sign up for ElevenLabs**](https://try.elevenlabs.io/clawhub) — free tier includes 10,000 characters/month!
   - Paid plans include 250+ minutes/month of Conversational AI

2. **Twilio Account**
   - Sign up: https://twilio.com
   - Need: Account SID, Auth Token, Phone Number (~$1.15/month for US)

## 🏗️ Architecture

```
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Your App  │────▶│ ElevenLabs  │────▶│   Twilio    │
│  (trigger)  │     │ Conv. AI    │     │   (call)    │
└─────────────┘     └─────────────┘     └─────────────┘
                           │                    │
                           ▼                    ▼
                    ┌─────────────┐     ┌─────────────┐
                    │  AI Agent   │     │  Phone      │
                    │  (voice)    │◀───▶│  Network    │
                    └─────────────┘     └─────────────┘
```

## 🚀 Quick Start

### Step 1: Get Your Credentials

```bash
# ElevenLabs
ELEVENLABS_API_KEY="your_api_key_here"

# Twilio (from console.twilio.com)
TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
TWILIO_AUTH_TOKEN="your_auth_token_here"
```

### Step 2: Buy a Twilio Phone Number

1. Go to Twilio Console → Phone Numbers → Buy a Number
2. Select a US number with **Voice** capability (~$1.15/month)
3. Enable international calling if needed (Geo Permissions)

### Step 3: Create ElevenLabs Agent

```bash
curl -X POST "https://api.elevenlabs.io/v1/convai/agents/create" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Reminder Agent...