Santa AI Agent

A SignalWire AI Agent - Santa's Gift Workshop with automated GitHub → Dokku deployments.

Features

• ✅ Auto-deploy on push to main/staging/develop
• ✅ Preview environments for pull requests
• ✅ Automatic SSL via Let's Encrypt
• ✅ Zero-downtime deployments
• ✅ Dynamic WebRTC token generation
• ✅ Gift search via RapidAPI

Setup

1. GitHub Secrets (App Configuration)

Add these secrets to your repository (Settings → Secrets → Actions):

Secret	Required	Description
SIGNALWIRE_SPACE_NAME	Yes	Your SignalWire space (e.g., myspace.signalwire.com)
SIGNALWIRE_PROJECT_ID	Yes	SignalWire project ID
SIGNALWIRE_TOKEN	Yes	SignalWire API token
RAPIDAPI_KEY	Yes	RapidAPI key for gift search
SWML_BASIC_AUTH_USER	No	Basic auth username for SWML endpoint
SWML_BASIC_AUTH_PASSWORD	No	Basic auth password for SWML endpoint

2. GitHub Environments

Create these environments (Settings → Environments):

• production - Deploy from main branch
• staging - Deploy from staging branch
• development - Deploy from develop branch
• preview - Deploy from pull requests

3. Deploy

Just push to a branch:

git push origin main      # → santa.yourdomain.com
git push origin staging   # → santa-staging.yourdomain.com
git push origin develop   # → santa-dev.yourdomain.com

Or open a PR for a preview environment.

Branch → Environment Mapping

Branch	App Name	URL
main	santa	santa.yourdomain.com
staging	santa-staging	santa-staging.yourdomain.com
develop	santa-dev	santa-dev.yourdomain.com
PR #42	santa-pr-42	santa-pr-42.yourdomain.com

Manual Operations

# View logs
ssh dokku@server logs santa -t

# SSH into container
ssh dokku@server enter santa

# Restart
ssh dokku@server ps:restart santa

# Rollback
ssh dokku@server releases:rollback santa

# Scale
ssh dokku@server ps:scale santa web=2

Local Development

pip install -r requirements.txt
uvicorn app:app --reload --port 8080

Test with swaig-test:

swaig-test app.py --list-tools