ai-sdr-agent

1. HeyGen LiveAvatar API Key - Get it from https://app.heygen.com/settings/api
2. Website URL - The website the AI SDR should represent

Parse any provided arguments: $ARGUMENTS

Step 1: Check for existing project or clone it

```bash

# Check if we're already in the project

if [ -f "package.json" ] && grep -q "liveavatar" package.json 2>/dev/null; then

echo "Already in LiveAvatar project"

else

# Clone the repository

git clone https://github.com/eNNNo/liveavatar-ai-sdr.git ai-sdr-agent

cd ai-sdr-agent

fi

```

Step 2: Install dependencies

```bash

npm install

```

Step 3: Configure API key

Create .env.local with the user's API key:

```bash

cat > .env.local << 'EOF'

LIVEAVATAR_API_KEY=

EOF

```

Replace with the actual key provided by the user.

Step 4: (Optional) Configure auto-start

If the user wants to skip the onboarding form, also add these to .env.local:

```

NEXT_PUBLIC_AUTO_START=true

NEXT_PUBLIC_WEBSITE_URL=

NEXT_PUBLIC_USER_NAME=Visitor

```

Step 5: Start the application

```bash

npm run dev

```

Step 6: Tell the user

• App is running at http://localhost:3001
• Open this URL in browser to create/talk to their AI SDR
• If auto-start is configured, it will immediately start the avatar session
• Session duration: 2 minutes per conversation
• They can create new sessions for different websites

| Error | Meaning | Solution |

|-------|---------|----------|

| Invalid API key | The LiveAvatar API key is wrong | Check key at https://app.heygen.com/settings/api |

| Website unreachable | Can't fetch the URL | Verify URL is correct and publicly accessible |

| Avatar expired | Default avatar needs renewal | Select different avatar or renew HeyGen subscription |

| Context creation failed | API limit or server issue | Wait and retry, or check HeyGen account status |

User: "Create an AI SDR for shopify.com using API key abc123"

You should:

1. Clone/setup the project
2. Create .env.local with LIVEAVATAR_API_KEY=abc123
3. Run npm install && npm run dev
4. Tell user to open http://localhost:3001 and enter "shopify.com" in the form